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Preface 



The IBM Series/ 1 Stand-Alone Utilities Guide describes each of the utility programs. 
It tells you: 

• What the utility does 

• How to use it 

• The output you receive 

• How to handle errors 

This publication is organized into seven chapters, each containing groups of related 
utility programs. Appendix M covers messages generated by each program and the 
appropriate action to be taken. 
To effectively use the stand-alone utility programs, you should be familiar with: 

• Basic data processing concepts 

• Assembler language coding 

• Modular programming concepts 

Prerequisite Publications 
none 
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Chapter 1. Introduction 



This manual explains how to use each of the utilities in detail. 

For each utility there is an example of a typical session of using the utility. This 
example shows your interaction with the utility— the prompts it issues and the responses 
you supply. It also covers errors that may occur during the interaction and how you 
handle them. The IBM-supplied names (module ID's) for these programs are shown in 
parentheses after the program name. 
The Utilities are: 

Automatic System Build copies a portion of the complete system from a diskette to 

the system disk. 

System Verification (SF) checks to find if all components of the system were copied 

to the system disk and also prints the location of the components on disk. 

Diskette IPL Bootstrap (IP) loads a program 1 cylinder in length (from location: 

cylinder 1, head 0, sector 1) into the high end of storage. 

Disk IPL Bootstrap! Loader (LI, L2) loads programs from the disk into main storage. 

Diskette Initialization (RI) initializes the diskette, writing ID records and checking for 

defective cylinders, and assigns alternate cylinders. 

Disk Initialization (FI) initializes the disk, verifying sector IDs and checking for 

defective sectors, and assigns alternate sectors. 

Create Diskette HDRl (CH) creates a HDRl record for a diskette, using information 

that you specify. 

Delete Diskette HDRl (DH) deletes the HDRl record for a specified diskette data file. 

Diskette to Disk Copy (RF) copies data from a specified diskette data file to a 

specified disk data file. 

Disk to Diskette Copy (FR) copies data from a specified disk data file to a specified 

diskette data file. 

Diskette to Printer Dump (RD) dumps the contents of a specified area on the diskette 

to the printer. 

Disk to Printer Dump (FD) dumps the contents of a specified area on the disk to the 

printer. 

Diskette Patch (TR) applies a patch (which you enter at the operator station) to a 

specified location on the diskette. 

Disk Patch (TF) applies a patch (which you enter at the operator station) to a 

specified location on the disk. 

Storage to Diskette Dump (SI, S2) dumps the contents of main storage to the 

diskette. 

Storage to Printer Dump (PI, P2J dumps the contents of main storage to the printer. 

Error Log Program (EL) formats system errors. 
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HARDWARE OVERVIEW 



The following is a list of hardware products referred to in this manual. The list includes 
the product name and the term used within this manual when referring to the product. 



Term Used Hereafter 

processor 

disk 

diskette 

printer 

operator station 



Product Name 

IBM 4955 or 4953 Processor 

IBM 4962 Disk Module 

IBM 4964 Diskette Module 

IBM 4974 Printer 

Any device that can be used as 

an operator station and is attached 

to the system through the 

ASCII teletypewriter adapter 

The minimum hardware configuration required to run a Series/1 program is: 

• 1 processor with 32KB of storage 

• 1 diskette unit 

• 1 disk 

• 1 printer 

• 1 operator station 
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USING THE UTILITY PROGRAMS 

I All programs (except the Error Log Program, Automatic System Build, Storage to 
Diskette Dump, and Storage to Printer Dump) are IPLed from the disk. All programs are 
on disk in a storage-image format, preceded by a header record designating the load point, 
entry point, size of the program, and maintenance information. 

To invoke a program, set the IPL switch to primary (disk) and press the LOAD key on 
the system console. Once the loader is in main storage, it prints a message at the operator 
station requesting the name or starting sector address of the program to be loaded: 
IP100AEXEC= 

You can enter either the 2-character name for the IBM-supplied programs (for example, 
Rl for diskette initialization) or the program's starting sector address. For any other 
programs, you must enter the program's starting sector address. Sector addresses must be 
specified in this format: 
ccchss 
where: 

ccc = the cylinder number in decimal 

h = the head number in decimal 

ss = the sector number in decimal 

After the program is loaded, it issues prompts at the operator station requesting you to 

enter certain information needed by the program before it can begin processing. This 

information is covered in the chapters describing the individual utilities. 

The utiUty prints an error message at the operator station and reissues the prompt if (1) 
the information you enter is syntactically incorrect or (2) if the utility encounters a 
recoverable error. Each time a prompt or message is printed at the operator station, it 
ends with a carriage return. You must also end your entries with a carriage return. 

If you are typing a line that is longer than 72 characters, there is an automatic carriage 
return after you type the 72nd character. 

In the Series/1 programs, a contiguous, logically related collection of data on a 
single disk or diskette is called a data file. Through the operator station, you can refer to 
a data file by specifying its device address, starting sector address, and ending sector 
address. Enter the information in this format: 
ddd,ccchss,ccchss 
where: 

ddd = the device address 

ccchss,ccchss = the starting and ending sector addresses of the data file 
The device address are fixed as follows: 



Device Address Device Type 






000 operator station 






001 printer 






002 diskette 






003 disk 






The ranges of the ccc, h, and ss values are: 






cylinder (ccc) 


head (h) 


sector (ss) 


Diskette-double-sided 0-74 


0-1 


1-26 


—single-sided 0-74 





1-26 


Disk 






Disk 0-302 


0-1 


0-59 



Note. CyUnder of the disk is reserved for the Bootstrap and Loader; cyUnder 1 is 
reserved for altemate sector assignments; cyhnder 302 is reserved for customer engineer 
use. On the diskette, track is reserved for system use; tracks 75 and 76 are reserved as 
alternate tracks to replace tracks that become defective. 
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Both the disk and diskette are supported in a cylinder mode. For example, the disk 
sector that follows sector address 005059 is 005100, and the disk sector that follows 
sector address 005159 is 006000. 

If a logically deleted record is encountered during any diskette operation other than 
the diskette to printer dump (RD), the message UNRECOVERABLE I/O ERROR will be 
written at the operator station. The error code included in the message denotes the 
presence of a control address marker at the diskette sector address specified, and the 
function terminates. For the diskette to printer dump utiUty, a deleted record on cylinder 
0, head 0, sectors 8-26 and cylinder 0, head 1, sectors 1-26 will print out the message 
PHYSICAL RECORD HAS BEEN LOGICALLY DELETED. All other sectors will print 
out UNRECOVERABLE I/O ERROR. 

For more detailed information on the disk and diskette, refer to the IBM 4962 Disk 
Storage Unit Description, GA34-0024, and the IBM 4964 Diskette Input /Output Unit 
Description, GA34-0023. 

If a program creates or moves data fQes, it prints a message at the operator station 
indicating the last sector written: 
id099I LAST SECTOR WRITTEN = ccchss 

Messages are always printed on one device line. Some of the messages in this manual are 
shown on two lines because of the message length. 

Making Corrections at the Operator Station 

If you should make typing errors while entering data at the operator station, you can 
correct these errors in the following manner. 
To correct one or more characters: 



You meant to type 






CO 10,50,100 


But you typed 






CO 10,60 


Now type 






^<- 50,100 


Type one left arrow C-^) for each character 
characters correctly and continue typing. 


you 


typed after the last correct character. Retype the 



To correct an entire line: 



You meant to type CT 10,20,'ABC,*DEF' 

But you typed CT 1 0,200,' ABC','DEF' 

Now type f 

Retype the line. An up arrow (t) causes a carriage return and you can correctly reenter your line. 



Note. If you want to interrupt the printing process at the operator station, hold down the 
CTRL key, then press the A key. 
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Chapter 2. System Build and Verification 



Automatic System Build (SB) 

WHAT THIS PROGRAM DOES 

The Automatic System Build program copies to disk the diskette shipped from IBM. A 
copy of this program resides on the diskette. The layout of the diskette is shown below. 



ccchss 


DISKETTE 


000001 


IPL/Bootstrap 


000003 


Reserved 


001001 


Auto-System Build 




Disk IPL/Bootstrap 




Disk Loader 




System Verification 




Diskette IPL/Bootstrap 




Storage to Printer Dump (Phase A) 




Storage to Printer Dump (Pliase B) 




Storage to Diskette Dump (Pliase A) 




Storage to Diskette Dump (Piiase B) 




Disk Initialization 




Diskette Initialization 




Create HDRl 




Delete HDRl 




Diskette to Printer Dump 




Disk to Printer Dump 




Diskette to Disk Copy 




Disk to Diskette Copy 




Diskette Patch 




Disk Patch 




Error Log 



The loader loads the contents of the diskette to a predefined area of the disk. When the 
diskette has been copied, the system is built on disk. 



HOW TO USE IT 



(1) mount the diskette, as shipped from IBM, 

(2) set the console IPL switch to alternate, and 

(3) press the LOAD Key. 

The hardware loads the bootstrap, which in turn loads the Automatic System Build 
program. No further input is necessary. 
The program issues this message: 



SBOOOI AUTOMATIC SYSTEM BUILD STARTED 
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Once the diskette is mounted, the program prints, from the VOLl label, the volume 
identifier field in the following message: 



SBIOOI DISKETTE VOLID=nnnnnn 



where imimrm is the volume identifier for the diskette. It then copies, to a predefined 
location on the disk, the contents of the diskette. There is no operator input required to 
buUd the system. Upon completion the program issues this message: 



SBOOII AUTOMATIC SYSTEM BUILD UTILITY COMPLETED 



THE OUTPUT YOU RECEIVE 



Output consists of a complete diskette copied onto the disk and the three preceding 
messages. If any errors occur while copying the diskette to disk, an appropriate I/O error 
message is printed at the operator station. 



HOW TO HANDLE ERRORS 



If an I/O error occurs, the program terminates after issuing an error message to the 
operator station. See Appendix M for a complete discussion of possible error codes. 



EXAMPLE 



The following is an example of the automatic system build program. In this example, the 
diskette mounted has VOLID=PID002. 

1. Mount the IBM diskette. 

2. Set console IPL switch to altemate. 

3. Press the LOAD Key. 



SBOOOI AUTOMATIC SYSTEM BUILD STARTED 

SBIOOI DISKETTE VOLID=PID002 COPIED 

SBOOII AUTOMATIC SYSTEM BUILD UTILITY COMPLETED 



After the diskette is copied, your system will be built on disk. 

Now use the System Verification program to insure that the components have been 
correctly copied to the system disk. 
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System Verification (SF) 
WHAT THIS PROGRAM DOES 

After you load the program, it ensures that your system is built properly by 
cross-checking each module on your IPLed system disk against a table containing 
expected module names. If any modules are missing, a message is printed indicating which 
specific program is not on the disk system. 

HOW TO USE IT 

Press the LOAD key. After the EXEC= message is printed at the operator station, enter 
either SF or the starting sector address (ccchss) of the program. When it is loaded, no 
further input is required. The program performs the verification, using an internal table of 
module names expected to be on the disk. 

THE OUTPUT YOU RECEIVE 

If your IPLed system disk is an incomplete system, an error message is printed at the 
operator station indicating the name of the module that was not found. No further 
verification processing is possible. 

The system map name contains header record data for all modules encountered before 
the error occured. If your system is correct, a system map containing header record data 
for each load module is printed, and a message verifying that the system was correctly 
built is printed at the operator station. 
The system map is printed in the following format: 

Program Name ccchss Entry Point Load Point Module Length User Data 

XX ccchss xxxx yyyy ^zzz aaaaa 



where: 

XX = the 2-character component ID 

ccchss = the address of header record on the disk 

XXXX = the entry point of the module in ccchss format 

yyyy = the load point of the module in ccchss format 

zzzz = the length of the module in hexadecimal 

aaaaaa = the description of the 2-character component ID 



HOW TO HANDLE ERRORS 



If the program encounters any of the following errors, it issues a message at the operator 
station: 

• Invalid header ID 

• Module missing on system disk 

• Module name missing in the system table 

• Incorrect header chain 

If an unrecoverable error occurs, the program abnormally terminates. To reinvoke the 
program, you must relPL. Unrecoverable errors are : 

• Operator Station I/O error 

• Disk I/O error 
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EXAMPLE 



The following is an example of the System Verification program. 



Operator Station Printout 


Explanation 


IPIOOA EXEC= 

SF 

SFOOOI SYSTEM VERIFICATION STARTED 
XX ccchss *xxxxx yyyyyy zzzzzz 
SF200I SYSTEM CORRECTLY BUILT 
SFOOII SYSTEM VERIFICATION COMPLETE 


The loader issues a request for the address of the 
program to be loaded. 

You enter the name of the System Verification 
program. 

The System Verification program has started. 

The system map is printed at the printer. 

There has been a successful system verification. 

The program is finished. 
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Chapter 3. Initial Program Load Programs 



Diskette IPL Bootstrap (IP) 

WHAT THIS UTILITY DOES 

When you press the LOAD key on the console, the hardware loads the bootstrap into 
main storage from the diskette. The bootstrap, in tum, loads the contents of cylinder 1, 
head 0, from the IPLed diskette. When the bootstrap is finished, register 7 contains the 
device address of the diskette you IPLed from. The program is loaded into the high end 
of storage and control is given to the first logical address of the program. 

Note. A standard linkage editor header is required on the diskette. 

HOW TO CREATE A DISKETTE 

You must create a special diskette for the diskette IPL bootstrap. See example below. 

Locate the ccchss of the program IP on the system verification listing. Using the disk to 
diskette copy program, copy the program IP to the diskette. You must start the copy 1 
disk sector beyond the beginning of the program to remove the header record. IP must be 
placed on the diskette at cylinder 0, head 0, sectors 1 and 2. 

HOW TO USE IT 

You invoke this utiUty by setting the IPL switch to alternate (diskette) and then pressing 

the LOAD key. 

Note. The bootstrap must be on cylinder 0, head 0, sectors 1 and 2 of the diskette. 
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HOW TO HANDLE ERRORS 



EXAMPLE 



If a diskette I/O error occurs, the utility tries to recover, if it can; otherwise, it 
terminates. 



The following is an example of placing the diskette bootstrap on a diskette. 



Operator Station Printout 


Explanation 


IP100AEXEC= 

FR 

FROOII DISK TO DISKETTE COPY 
STARTED 

FRIOOA FROM DATA AREA= 
003, 002126, 002126 

FR200A TO DATA AREA= 
002, 000001, 000002 

FR099I LAST SECTOR WRITTEN IS 
000002 

FROOII DISK TO DISKETTE COPY 
COMPLETED 

FRIOOA FROM DATA AREA= 


The loader issues a request for the program that is 
to be executed. 

You enter the name of the Disk to Diskette Copy 
utility. 

The Disk to Diskette Copy utility has started. 

The utility prompts for the source data file infor- 
mation. 

You enter the device address and the starting 
sector address +1 of the program IP. This re- 
moves the header record from the diske'tte boot- 
strap. Only one disk sector is copied. 

The utility issues this prompt for the destination 
data file information. 

You enter the device address and the starting 
sector address where the bootstrap must reside 
on cylinder 0, head 0, sectors 1 and 2. 

The utility prints the address of the last sector 
written on the diskette. 

The copy was successfully completed. 

The utility prompts for a new source data file 
for the next copy operation. 
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Disk IPL Bootstrap/Loader (LI, L2) 
WHAT THIS UTILITY DOES 



When you press the LOAD key on the console, the hardware loads the bootstrap into 
main storage from the disk. The bootstrap then loads and gives control to the loader. 
Once the loader is in main storage, it issues a prompt through the operator station 
requesting the two character IBM-supplied name or the ccchss location of the program 
you want loaded and given control on level 0. The loader brings into storage the program 
you request and passes control to it. 
Note. When the requested program receives control, these conditions exist: 

• On levels 1, 2, and 3 the LSR, JAR, and all general-purpose registers contain zeros. 

• On level 0: 

— Register 3 contains the device addresses of the operator station in the first byte and 
the printer in the second byte. 

— Register 4 contains the size of storage: 

7FFF is 32K 
BFFF is 48K 
FFFF is 64K. 

— Register 5 contains the device address of the IPLed device in the low-order byte. 

— Register 6 contains the value of the cylinder that contains the header record of the 
requested program. 

— Register 7 contains the values for the head and sector that contain the header 
record of the requested program. 

• In the LSR, the supervisor state bit for level is on. 

• The IPLed device and the operator station are unprepared and all interrupts are 
disabled. 



HOW TO USE IT 



You invoke this utiUty by pressing the LOAD key. 

Note. The bootstrap must be on cyUnder 0, head 0, sector of the disk. The loader 

resides on cylinder 0, head 0, sectors 1—13. 

Once the loader is in control, you can specify which program you want loaded for 
execution. The loader prints this prompt at the operator station: 



IPIOOA EXEC^ 



All IBM-supplied programs can be loaded by name. All user programs are loaded by disk 
address. If you load a program by name, enter: 



program name 



where: 

program name is a 2-character IBM-suppUed name for the program. 
If you enter the program's location, it must be in this form: 



ccchss 



where: 

ccc 

h 

ss 



= a 3-digit decimal cyUnder number in the range 002—301 

= the head number, either or 1 

= a 2-digit decimal sector number in the range 00—59 



Initial Program Load Programs 3-3 



The loader assumes that the program you requested is on the same device you IPLed 
from. There is a restriction on how big this program can be. The program's maximum size 
is the size of storage minus 2K bytes. The last 2K of storage is reserved for the loader, but 
may be used after control is passed to the program. 

If the information you enter is syntactically incorrect, an error message is printed at the 
operator station and the prompt is repeated. If the information you enter is syntactically 
correct, the loader checks your program's header record to determine: 

• If it is a valid header 

• The load point of the program 

• The entry point of the program 

• If the program can fit into the available storage 

If an invalid header is found, the prompt is reissued. If the information is correct, your 
program is given control. 

THE OUTPUT YOU RECEIVE 

The only output from this utility is the prompt IPIOOA EXEC= and possibly some error 
messages. 

HOW TO HANDLE ERRORS 

If the utility encounters a recoverable error, it prints an error message and reissues the 
prompt. Recoverable errors are : 

• Invalid sector address— address is out of range for the device, contains non-decimal 
digits, or is the incorrect length 

• Invalid header record 

• InvaUd program name 

• Program too large for storage 

If the utility encounters an unrecoverable error, it issues a LEX with a code in the 
operand of the instruction. To reinvoke the utility, you must relPL. Unrecoverable errors 
are: 

• I/O error to the operator station 

• I/O error to disk 
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Chapter 4. Initialization Programs 



Diskette Initialization (RI) 

WHAT THIS UTILITY DOES 

This utility initializes either a single-side or double-sided diskette in a diskette drive. The 
initialization consists of three steps: 

• The utility formats each track into 128-byte sectors. 

• The utility analyzes each track. If it finds a defective sector, it considers that entire 
cylinder to be defective, and assigns an alternate cylinder. The next sequential cylinder 
is assigned as the alternate. If more than two cylinders are defective, the diskette is 
flagged as unusable. 

• On cylinder 0, head 0, the utility: 

— Writes the VOLID (volume identification) on sector 7. 

— Writes one HDRl (header 1) on sector 8. This HDRl describes the entire data area 
(cylinders 1-74) as one data set. 

— Writes the remaining HDRl s (9-26) as deleted headers. 

— Writes the ERRMAP on sector 5, This contains the address of defective cylinders up 
to a maximum of two in the format cch, where cc is the number of the defective 
cylinder and h is the head number. 

See the following pages for the format of the VOLl and HDRl field. 

If you try to initialize a diskette that has been previously initialized, you destroy all 

data on the diskette. Reinitialization rewrites the complete diskette surface. 



VOLl LABEL FORMAT 



Character 






Initialization 


Position 


Field Name 


Length 


Value 


000 


Label Identifier 


3 


'VOL' 


003 


Label Number 


1 


1 


004 


Volume Identifier 


6 


user id 


010 


Accessibility 


1 


space 


Oil 


Reserved 


26 


spaces 


037 


Owner ID 


14 


spaces 


051 


Reserved 


20 


spaces 


071 


Volume Surface Indicator 


1 


space (single-sided) 
2 (double-sided) 


074 


Reserved 


3 


space 


075 


Physical Record Length 


1 


space 


076 


Physical Record Sequence Code 


2 


spaces 


078 


Reserved 


1 


space 


079 


Label-Standard Version 


1 


'W 
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HDRl LABEL FORMAT 



Character 


Field 




Initialized 


Position 


Name 


Length 


Value 


000 


Label Identifier 


3 


'HDR' 


003 


Label Number 


1 


1 


004 


Reserved 


1 


space 


005 


FUelD 


17 


8 char DSNs 
+ 9 blanks 


022 


Block Length 


5 


00128 


027 


Record Attribute 


1 


space 


028 


Beginning of Extent 


5 


cchss 


033 


Physical Record Length 


1 


space 


034 


End of Extent 


5 


cchss 


039 


Record/Block Format 


1 


space 


040 


Bypass Indicator 


1 


space 


041 


File Security 


1 


space 


042 


Write Protect Indicator 


1 


space 


043 


Exchange Type Indicator 


1 


space 


044 


Multi-Volume File 


1 


space 


045 


Volume Sequence Indicator 


2 


space 


047 


Creation Date 


6 


space 


053 


Record Length 


4 


space 


057 


Offset To Next Record Space 


5 


space 


062 


Reserved 


4 


space 


066 


Expiration Date 


6 


space 


072 


Verify/Copy Indicator 


1 


space 


073 


File Organization 


1 


space 


074 


End of Data Address 


5 


cchss 


079 


Reserved 


1 


space 



The initialized diskette that this utiUty produces is formatted as a basic exchange 
diskette, with a VOLID that you specify. The portion of the diskette that is available for 
your use (cylinders 1—74) is a basic exchange EBCDIC data file. It is specified by the first 
HDRl record (at cylinder 0, head 0, sector 8). The basic exchange data file has these 
characteristics: 

• The data file is organized sequentially. 

• A record is 128 bytes long. 

• Records are in fixed-length format and are unblocked and unspanned. 

• The physical record length is 1 28 bytes. 

• The data file identifier (HDRl) is a simple name, containing up to 8 characters. 

• All character data is represented in EBCDIC. ASCII is not supported. 
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HOW TO USE IT 



Press the LOAD key. After the EXEC= message is printed at the operator station, enter 
either RI or the starting sector address (ccchss) of the utility. When it is loaded, the 
utility responds with: 



RIOOOI DISKETTE IMTIALIZATION STARTED 



The utility issues this prompt requesting the diskette device address: 



RIllOA DEVICE ADDRESS= 



Enter the information in this form: 



ddd 



where ddd is the device address, in decimal. This number must be in the range 0—127. 
If the diskette already has a VOLID, the utility responds with: 



RU25I CURRENT VOLID= cccccc 



where cccccc is the name of the current VOLID on the diskette. The utility issues a 
prompt asking whether or not to proceed with initializing this diskette : 



RI127A DO YOU WANT TO INITIALIZE THIS DISKETTE? 
RESPOND YES OR NO 



If you respond NO, the utility issues a cycle terminated message and recycles to the 
RIllOA message. If you respond YES, the utility issues this prompt requesting the name 
of your volume: 



RIUOA NEW VOLID= 



Enter the VOLID you want on your volume in this form: 



where cccccc is a 1-to 6-character alphameric name. 

If the information you entered is correct the utility does the initialization. 
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THE OUTPUT YOU RECEIVE 

This utility produces an initialized diskette in basic exchange format (one that is 
interchangeable with other systems). If any defective cylinders are encountered, the 
utility issues this message, one for each defective cylinder, in the following form: 



8I140I DEFECTIVE CYUNDER cch 



where cc is the number of the defective cylinder and h is the head number. The utility 
prints this message to indicate that it has finished: 



mdoir pi^Eii^ ii^imuzimoN co^ 



HOW TO HANDLE ERRORS 



EXAMPLE 



If the utility encounters a recoverable error, it prints an error message and reissues the 
prompt. Recoverable errors are : 

• Device address not valid 

• Device at specified device address not diskette device 

• Invalid VOLID/header name 

• Cylinder defective 

• Unable to initialize because there are too many defective cylinders (two cylinders is 
the maximum) 

• Cylinder unformatted 

If the utility encounters an unrecoverable I/O error, it abnormally terminates. To 
reinvoke the initialization utility, you must relPL. 



The following example shows a typical initialization, where the diskette device address is 
002, the user's new VOLID is VOLOOl, and the old VOLID is VOL999. 



Operator Station Printout 


Explanation 


IP100AEXEC= 


The loader issues a request for the program that is 




to be loaded. 


RI 


You enter the name of the Diskette Initialization 




utility. 


FIOOOI DISKETTE INITIALIZATION 


The Diskette Initialization utility has started. 


STARTED 




Rill A DEVICE ADDRESS= 


The utility issues a request for the device address 




of the Diskette. 


002 


The diskette is at device address 002. 


RI125I CURRENT VOLID = VOL999 


The current name of your diskette is VOL999. 


RI127A DO YOU WANT TO INITIALIZE 


This prompt asks you if you wish to continue to 


THIS DISKETTE? RESPOND YES OR NO 


initialize this diskette. 


YES 


You respond YES to continue. 


RI120ANEWVOLID= 


The utility issues a request for you to supply the 




new VOLID. 


VOLOOl 


The new name of your diskette is VOLOOl. 


RI140I DEFECTIVE CYLINDER 1 10 


These two cylinders have bad sectors. 


RI140I DEFECTIVE CYLINDER 270 


This message is not printed if all cylinders are 




good. 


RIOOII DISKETTE INITIALIZATION 


The diskette is initialized. 


COMPLETED 
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Disk Initialization (FI) 
WHAT THIS UTILITY DOES 



This utility has two initialization types— primary initialization and alternate sector 
assignment. 

Use primary initialization for complete initialization when the disk is installed or when 
complete reinitialization is desired. It first verifies and corrects sector IDs, and then 
analyzes the disk surface to find defective sectors. When it finds a defective sector, it 
assigns an alternate sector on cylinder 1, then prints a message at the operator station. 

Alternate sector assignment lets you assign alternate sectors for those sectors found to 
be defective. It also tries to move data from the defective sector to the alternate. 
Note. Because there are only 120 alternate sectors available, and because once an 
alternate has been assigned, the defective sector caimot be recovered unless you specify 
that all sector IDs are to be rewritten during initialization. Therefore, use alternate sector 
assignment only when necessary. 

If you try to initialize a disk that has been previously initialized, you destroy aU data on 
the disk. Reinitialization rewrites the complete disk surface. 



HOW TO USE IT 



Press the LOAD key. After the EXEC= message is printed at the operator station, enter 
either FI or the starting sector address (ccchss) of the utility. When it is loaded, the utility 
responds with: 



FIOOOI DISK INITIALIZATION STARTED 



The utility then issues this prompt requesting the device address of the disk to be 
initialized. 



FiaOA DEVICE ADDRESS* 



Enter the requested information in this form: 



ddd 



where ddd is the disk device address. This number must be in decimal, in the range 
0-255. 

The utility then issues this prompt requesting the type of initialization you want to 
perform: 



FI120A TYPE- 



Enter the requested information in this form: 



tt 



where tt is the initialization type. Enter PI for primary initialization, or AS for alternate 
sector assignment. The utility's next action depends on the initialization type you 
entered. If you entered PI, the utility issues this prompt requesting you to specify 
whether the defective sector flags are invalid: 



FI003I FRIMARY INITUUZATION MODE 

FI150A ARE DEFECnVE SECTOR FtAGS INVAUD 
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Enter either YES or NO. If you respond YES, the utility rewrites all sector IDs and 

reinitializes the flag byte, where possible. If you reply NO, the defective sector flag bit of 

each sector ID is retained. 

Note. You should respond YES only if you want to rewrite all the sector IDs. Rewriting 

the sector IDs causes the loss of the IBM assigned defective sector flags. 

If you entered AS, the utility issues this prompt requesting you to specify the defective 

sector address: 



FI(H)4I ALTERNATE SECTOR MODE 
FU30A SECTOR ADDRESS* 



Enter the requested information in this form: 



ccchss 



where ccchss is the address of a sector that you have found to be defective. The utility 
assigns an alternate sector on cylinder 1 and then tries to move the data from the 
defective sector onto the alternate. 



THE OUTPUT YOU RECEIVE 



If you request primary initiaUzation, the utility prints a message for each defective sector 
it finds. The message looks like this: 



FIMOl ALTERNATE SECTOR ASSIGNED FOR ccchss 



where ccchss is the address of the defective sector. A successful assignment of an alternate 
in AS mode prints the same message. When the utility has finished either type of 
initiaUzation, it prints this message : 



FIOOII DISK INITIALIZATION COMPLETED 
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HOW TO HANDLE ERRORS 



EXAMPLES 



If the utility encounters a recoverable error, while processing your input to the operator 
station, it prints an error message and reissues the prompt. Recoverable errors are: 

• Device address not valid (for example, defective character, out of range, not 3 
characters) 

• Device at specified device address not a disk device 

• Invalid initialization type— must be either AS or PI 

• Invalid sector address (for example, out of disk range, invaUd character, not 6 
characters) 

• InvaUd response to sector flag prompt 

The following error types cause a warning message, but allow for normal program 
completion without any response from you. 

• Unable to recover data in alternate sector mode 

• Unable to write sector ID 

• Defective sector on cylinder 1 

If the utility encounters one of the following three unrecoverable errors, it abnormally 
terminates. To reinvoke the initialization utility, you must relPL. 

• Unable to assign an alternate sector because alternate cylinder is full 

• Unable to initialize because there are too many defective sectors (the maximum is 120 
sectors) 

• Unrecoverable I/O error 

• Attempt to assign alternate for defective sector oh cylinder 1 

• Unexpected or invalid retum codes from external system routines 



The following example shows a typical primary initialization session for a disk at device 
address 075. 



Operator Station Printout 


Explanation 


IPIOOA EXEO 


The loader issues a request for the program that is 
to be executed. 


FI 


You enter the name of the Disk Initialization 
utility. 


FIOOOI DISK INITIALIZATION STARTED 


The disk initialization utility started. 


FIllOA DEVICE ADDRESS= 


The utility issues a request for the device address 
of the disk to be initialized. 


075 


The disk is at device address 075. 


FI120A TYPE= 


The utility issues a request for the type of 
initialization you want. 


PI 


You request a primary initialization. 


FI003I PRIMARY INITIALIZATION MODE 


The utility enter primary mode. 


FI150A ARE DEFECTIVE SECTOR 
FLAGS INVALID 


The utility issues a request to find if the defective 
flags are invalid. 


NO 


You specify that the defective sector flags are 
valid. 


FI140I ALTERNATE SECTOR 
ASSIGNED FOR 240120 


The utility assigned alternate sectors for defective 
sectors 240120 and 240140. 


FI140I ALTERNATE SECTOR 
ASSIGNED FOR 240140 




FIOOII DISK INITIALIZATION COMPLETED 


The utility is finished. 
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The next example shows a typical alternate sector assignment session. 



Operator Station Printout 


Explanation 


IP100AEXEC= 

ccchss 

FIOOOI DISK INITIALIZATION STARTED 
FIllOA DEVICE ADDRESS= 

003 
FI120ATYPE= 

AS 

FI004I ALTERNATE SECTOR MODE 

FI130A SECTOR ADDRESS= 

100037 

FI140 ALTERNATE SECTOR ASSIGNED 

FIOOII DISK INITIALIZATION 
COMPLETED 


The loader issues a request for the program that is 

to be executed. 

You enter the starting sector address of the Disk 

Initialization utility. 

The Disk Initialization has started. 

The utility requests the device address of the Disk 

to be initialized. 

The disk is at device address 003. 

The utility issues a request for the type of 

initialization you want. 

You request alternate sector assignment. 

The utility issues a message telling you that 

alternate sector assignment is ready. 

The utility issues a request for the sector you want 

an alternate assigned for. 

The defective sector is sector 100037. 

The utility issues a message that the sector 

assignment is successful. 

The utility is finished. 
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Chapter 5. Create and Delete Programs 



Create Diskette HDRl (CH) 

WHAT THIS UTILITY DOES 

Using information that you supply, tliis utility creates a basic exchange HDRl record for 
a diskette data file. If you want to create a HDRl of any other format, see the IBM 
General Information Manual, GA21-9182-1, 

If the diskette initialization utility initialized the diskette, the HDRl describing the 
extents of the entire diskette must be deleted before the utility can create any additional 
HDRls. 



HOW TO USE IT 



Press the LOAD key. After the EXEC= message is printed at the operator station, enter 
either CH or the starting sector address (ccchss) of the utility. After it is loaded, the 
utility issues this message: 



CHOOOI CREATE HDRl UTILITY STARTED 



The utiUty then issues this prompt requesting the diskette device address: 



CHllOA DEVICE ADDRESS= 



Enter the requested information in this form: 



ddd 



where ddd is the diskette device address, in decimal. This number must be in the range 

0-127. 

The utility issues this prompt requesting the name of your data file described by the 

HDRl record. 



CH120A HEADER NAME* 



Enter the requested information in this form: 



where cccccccc is a 1-to 8-character alphameric name. The utility issues this prompt 
requesting the starting and ending sector addresses of the data file to be defined by this 
HDRl record. 



CHI30A EXTENTS? 
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Enter the information in this form: 



ccchss,ccchss 



where ccchss,ccchss are the starting and ending sector addresses of the next data file. The 
utility issues this prompt requesting the address, within the data file, to write the last data 
item. 



CH140A END OF FILE 



Enter the information in this form: 



ccchss 



where ccchss is the address of the next sector in the data file available for data. If you 
enter the information correctly the utility creates the HDRl record. 



THE OUTPUT YOU RECEIVE 



This utility writes a HDRl record to the diskette. When the utility has finished 
successfully, it prints this message : 



CHOOII CREATE HDRl UTILITY COMPLETED 



When the utility completes unsuccessfully, an error message is printed along with the 
following message: 



CH299T CREATE HDRl ABNORMAL CYCLE END 
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The utility then initiates another CREATE operation by reissuing the DEVICE 
ADDRESS= prompt. The utility continues in this mode until you terminate it by pressing 
the LOAD key. The following is a description of the HDRl fields that will be initialized 
by this utility. 



Character 


Field 




Initialized 


Position 


Name 


Length 


Value 


000 


Label Identifier 


3 


*HDR' 


003 


Label Number 


1 


1 


004 


Reserved 


1 


space 


005 


Data File ID 


17 


8 char.*DSNs 
+ 9 blanks 


022 


Block Length 


5 


00128 


027 


Record Attribute 


1 


space 


028 


Beginning of Extent 


5 


cchss* 


033 


Physical Record Length 


1 


space 


034 


End Of Extent 


5 


cchss* 


039 


Record/Block Format 


1 


space 


040 


Bypass Indicator 


1 


space 


041 


Data File Security 


1 


space 


042 


Write Protect Indicator 


1 


space 


043 


Exchange Type Indicator 


1 


space 


044 


Multi-Volume Data File 


1 


space 


045 


Volume Sequence Indicator 


2 


space 


047 


Creation Date 


6 


space 


053 


Record Length 


4 


space 


057 


Offset To Next Record Space 


5 


space 


062 


Reserved 


4 


space 


066 


Expiration Date 


6 


space 


072 


Verify/Copy Indicator 


1 


space 


073 


Data File Organization 


1 


space 


074 


End Of Data Address 


5 


cchss* 


079 


Reserved 


1 


space 



*— This is the data you entered 
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HOW TO HANDLE ERRORS 



EXAMPLE 



If the utility encounters a recoverable error, it prints an error message and reissues the 
prompt. Recoverable errors are : 

• Invalid ccchss 

• Wrong number of arguments 

• Device at specified device address not a diskette device 

• End of fQe address you specified not within the data extents 

• Data file extents in conflict with each other 

• Invalid data file name 

• Invalid device address 

• Extents not in basic exchange data area 

If the utility encounters an unrecoverable error, it abnormally terminates the CREATE 
operation with an abnormal cycle end message. The utility then recycles to the prompt 
for the device address. The unrecoverable errors are: 

• Data file overlaps an existing data file 

• No available HDRls 

• Extent arrangement indicator incompatible with the data file extents requested 

• Name you entered duplicates one that already exists on the volume 

• Unrecoverable I/O error 

• VOLID is not compatible with the basic exchange data file 

• InvaUd HDRl on diskette 



The following example shows a typical create HDRl session: 



Operator Station Printout 


Explanation 


IP100AEXEC= 


The loader issues a request for the program that is 
to be executed. 


CH 


You enter the name of the Create HDRl utility. 


CHOOOI CREATE HDRl 
UTILITY STARTED 


The Create HDRl utility has started. 


CHllOA DEVICE ADDRESS= 


The utility issues a request for the device address 
of the diskette. 


050 


The Diskette is at device address 050. 


CH120A HEADER NAME= 


The utility issues a request for the name you v\^ant 
to give your HDRl record. 


V0LDATA2 


You enter V0LDATA2. 


CH130AEXTENTS= 


The utility issues a request for where you want to 
locate your data file. 


037015,038025 


The data file extends from sector 037015 to sector 
038025. 


CH140A END OF FILE= 


Enter the sector address of the last data item. 


038001 


The data ends at sector 038001. 


CHOOII CREATE HDRl 
UTILITY COMPLETED 


The HDRl record is created. 


CHllOA DEVICE ADDRESS= 


This prompt initiates another CREATE operation. 
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Delete Diskette HDRl (DH) 

WHAT THIS UTILITY DOES 

This utility deletes the HDRl record for a specified data file and rewrites it as unused. 



HOW TO USE IT 



Press the LOAD Key. After the EXEC= message is printed at the operator station, enter 
either DH or the starting sector address (ccchss) of the utility. When it is loaded, the 
utility issues this message: 



DHOOOI DELETE HDRl UTILITY STARTED 



The utility then issues this prompt requesting the diskette device address: 



DHllOA DEVICE ADDRESS= 



Enter the requested information in the following form: 



ddd 



where ddd is a 3-digit decimal number in the range 0—127. The utility enters this prompt 
requesting the name of the HDRl record you want to delete: 



DHl 20 A HEADER NAME*' 



Enter the information in this form: 



cccccccc 



where cccccccc is a 1-to 8-character alphameric name. If the information you enter is 
correct, and there are no other errors, the utility deletes the HDRl. 



THE OUTPUT YOU RECEIVE 



This utility rewrites the HDRl record as unused. When the utility has successfully 
finished, it prints: 



DHOOil DELETE HDRl UTILITY COMPLETED 



or if the utility is unsuccessful, it prints: 



C 



minr] delete nmn cycle error end 



The utility then initiates another DELETE HDRl operation, and reissues the DEVICE 
ADDRESS= prompt. The utility will continue in this mode until you press the LOAD 
key. 
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HOW TO HANDLE ERRORS 



EXAMPLE 



If the utility encounters a recoverable error, it prints an error message and reissues the 
prompt. Recoverable errors are; 

• Invalid device address 

• Device at specified device address not a diskette device 

• Invalid data file name 

If the utility encounters an unrecoverable error, it abnormally terminates the delete cycle. 
The utility then recycles to the prompt for the device address. The unrecoverable errors 
are: 

• Extent arrangement indicator incompatible with the data file extents to be deleted 

• HDRl name not found 

• Unrecoverable I/O error 

• VOLID incompatible for basic exchange data sets 

• Invalid HDRl on diskette 



The following example shows a typical delete HDRl session: 



Operator Station Printout 


Explanation 


IP100AEXEC= 

DH 

DHOOOI DELETE UTILITY HDRl 

STARTED 

DHl 10 A DEVICE ADDRESS= 

002 

DHl 20 A HEADER NAME= 

V0LDATA2 

DHOOII DELETE HDRl UTILITY 

COMPLETED 

DHllOA DEVICE ADDRESS= 


The loader issues a request for the program that is 
to be executed. 

You enter the name of the Delete HDRl utility. 

The Delete HDRl utility has started. 

The utility requests the device address of the 

Diskette. 

"Hie Diskette is at device address 002. 

The utility issues a request for the name of the 

HDRl record you want deleted. 

The name of the HDRl record is V0LDATA2. 

The HDRl record is deleted. 

The utility initiates another DELETE HDRl 
operation. 



5-6 GC34-0070 



Chapter 6. Copy, Dump and Patch Programs 



Diskette To Disk Copy (RF) 

WHAT THIS UTILITY DOES 

After you load this utility, it copies a specified data file from a diskette to a disk. There 
are two diskette sectors per disk sector. 



HOW TO USE IT 



Press the LOAD key. After the EXEC= message is printed at the operator station, enter 
either RF or the starting sector address (ccchss) of this utility. When it is loaded, the 
utility responds with: 



RFOOOI DISKETTE TO DISK COPY STARTED 



The utility issues this prompt for the source data file information: 



RFIOOA FROM DATA AREA- 



Enter the information in this form: 



ddd,ccchss,ccchss 



where: 

ddd = the diskette device address in decimal 

ccchssjccchss = the starting and ending sector addresses 

deUmiting the location of the data file information to be copied 

from the diskette 
The utiUty issues this prompt for the destination data file information: 



RF200A TO DATA AREA= 



Enter the information in this form: 



ddd,ccchss,ccchss 



where: 

ddd 
ccchssjccchss 



= the disk device address in decimal 

= the starting and ending sector addresses delimiting the location on 
disk into which the data file information is to be copied 
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If there are no errors, the utility checks the size of the destination data file. If the 
destination data file is too small, the utility issues an error message and recycles; 
otherwise, it performs the copy as you requested. If you copy an odd number of diskette 
sectors, the utihty pads (with zeros) the last 128 bytes of the last disk sector written. 
Once the copy is completed, a completion message is written at the operator station and 
followed by another prompt for source data file information. The utihty will continue in 
this mode until you terminate it in some manner (for example, by pressing the LOAD 
key). 

THE OUTPUT YOU RECEIVE 

When this utihty has finished copying the information you requested, it prints this 
message at the operator station: 



RF0991 LAST SECTOR WRITTEN = ccchss 



where: 

ccchss = the last sector written on the disk. 
After that message, it prints: 



RFOOll DISKETTE TO DISK COPY COMPLETED 



This indicates that the copy is completed. The utihty then reissues the FROM DATA 
AREA= prompt. 

HOW TO HANDLE ERRORS 

If the utihty encounters a recoverable error, it prints an error message and reissues the 
prompt. Recoverable errors are : 

• Response parameter too short or too long 

• Response does not have three parameters 

• Invalid device address (negative number, non-decimal digits, or greater than 255) 

• Device at specified device address not diskette device (for source) or disk device (for 
destination) 

• Invalid sector address (out of range, non-decimal digits, or wrong number of 
characters) 

• Starting sector address greater than ending sector address 

• Source data file larger than the destination data file 

If the utility encounters an unrecoverable I/O error to the disk or diskette, it 
abnormally terminates the cycle with an error message and reissues the FROM DATA 
AREA= prompt. If an unrecoverable error occurs at the operator station, the utility 
terminates. 
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EXAMPLE 



The following is an example of the diskette to disk copy utility. The diskette device 
address is 002, with starting sector address 037015 and ending sector address 037125. 
The disk device address is 003, with starting sector address 240120 and ending sector 
address 240140. 



Operator Station Printout 


Explanation 


IP100AEXEC= 


The loader issues a request for the program that is 




to be executed. 


RF 


You enter the name of the Diskette to Disk Copy 




utility. 


RFOOOI DISKETIE TO DISK COPY STARTED 


The Diskette to Disk Copy utiUty has started. 


RFIOOA FROM DATA AREA= 


The utiUty prompts for the source data file 




information. 


003,037015,037125 


You enter the device address, starting sector 




address, and the ending sector address for the 




source data file information. 


RF007A INCORRECT DEVICE TYPE- 


The device type is incorrect. 


MUST BE DISKETTE 




RFIOOA FROM DATA AREA= 


The utility reissues the prompt for the source data 




file information. 


002,037015,037125 


You enter the correct device address, starting 




sector address, and ending sector address for the 




source data file information. 


RF200A TO DATA AREA= 


The utility issues this prompt for the destination 




data file information. 


003,240120,240140 


You enter the device address, starting sector 




address, and ending sector address for the 




destination data file. 


RF099I LAST SECTOR WRITIEN IS 240138 


The address of the last sector written on the disk. 


RFOOII DISKEITE TO DISK COPY 


The copy was successfully completed. 


COMPLETED 




RFIOOA FROM DATA AREA= 


The utility prompts for a new source data file for 




the next copy function. 
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Disk To Diskette Copy (FR) 

WHAT THIS UTILITY DOES 

After you load this utility, it copies a specified data file from a disk to a diskette. There 
are two diskette sectors per disk sector. 



HOW TO USE IT 



Press the LOAD key. After the EXEC= message is printed at the operator station, enter 
either FR or the starting sector address (ccchss) of the utiUty. When it is loaded, the 
utility responds with: 



FROOOI DISK TO DISKETTE COPY STARTED 



The utility issues this prompt for the source data file information: 



FRIOOA PROM DATA AREA= 



Enter the information in this form: 



ddd,ccchss,ccchss 



\^ere: 

ddd = the disk device address in decimal 

ccchss,ccchss = the starting and ending sector addresses 

delimiting the location of the data file information to be copied 

from the disk 
The utility issues this prompt for the destination data file information: 



FR200A TO DATA AREA*' 



Enter the information in this form: 



ddd ,ccchss,ccchss 



where: 

ddd = the diskette device address in decimal 

ccchsSjCcchss = the starting and ending sector addresses delimiting the location on 

the diskette into which the data file information is to be copied 
If there are no errors, the utility checks the size of the destination data file. If the 
destination data file is too small, the utility issues an error message and recycles. 
Otherwise, it performs the copy as you requested. Once the copy is completed, a 
completion message will be written at the operator station and followed by another 
prompt requesting source data file information. The utility will continue in this mode 
until you terminate it in some manner (for example, by pressing the LOAD key). 
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THE OUTPUT YOU RECEIVE 

When this utUity has finished copying the information you requested, it prints this 
message at the operator station: 



FR099I LAST SECTOR WRITTEN - ccchss 



where: 

ccchss = the last sector written on the diskette 
After that message, it prints: 



FROOII DISK TO DISKETTE COPY COMPLETED 



This indicates that the copy is completed. The utility then reissues the FROM DATA 
AREA= prompt. 

HOW TO HANDLE ERRORS 

If the utility encounters a recoverable error, it prints an error message and reissues the 
prompt. Recoverable errors are: 

• Response parameter too short or too long 

• Response does not have three parameters 

• Invalid device address (negative number, non-decimal digits, or greater than 255) 

• Device at the specified device address not a disk device (for source) or diskette device 
(for destination) 

• Invalid sector address (out of range, non-decimal digits or wrong number of characters) 

• Starting sector address greater than ending sector address 

• Source data file larger than destination data file 

If the utility encounters an unrecoverable I/O error to the disk or diskette, it abnormally 
terminates the cycle with an error message and reissues the FROM DATA AREA= 
prompt. 
If an unrecoverable I/O error occurs at the operator station, the utility terminates. 
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EXAMPLE 



The following is an example of the disk to diskette copy utility. The disk device address is 
003, with starting sector address 240120 and ending sector address 240140. The diskette 
device address is 002, with starting sector address 037015 and ending sector, address 
039010. 



Operator Station Printout 


Explanation 


IPIOOAEXEO 


The loader issues a request for the program that is 




to be executed. 


FR 


You enter the name of the Disk to Diskette Copy 




utility. 


FROOOI DISK TO DISKETTE COPY 


Ihe Disk to Diskette Copy utility has started. 


STARTED 




FRIOOA FROM DATA AREA= 


The utiUty prompts for the source data file 




information. 


003,240120,240140 


You enter the device address, starting sector 




address, and the ending sector address for the 




source data file information. 


FR200A TO DATA AREA= 


The utility issues this prompt for the destination 




data file information. 


002,039010,037015 


You enter the device . address, starting sector 




address and the ending sector address for the 




destination data file information. 


FR016A END SECTOR LESS THAN 


The information entered is incorrect. 


START SECTOR 




FR200A TO DATA AREA= 


The utility reissues the prompt for the destination 




data file information. 


002,037015,039010 


You enter the correct device address, starting 




sector address, and ending sector address for the 




destination data file. 


FR099I LAST SECTOR WRITTEN IS 038004 


The utility prints the address of the last sector 




written on the diskette. 


FROOII DISK TO DISKETTE COPY 


The copy was successfully completed. 


COMPLETED 




FRIOOA FROM DATA AREA= 


The utihty prompts for a new source data file for 




the next copy operation. 
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Diskette To Printer Dump (RD) 

WHAT THIS UTILITY DOES 

This utility dumps the contents of a specified data file from the diskette on the printer. 



HOW TO USE IT 



Press the LOAD key. After the EXEC= message is printed at the operator station, enter 
either RD or the starting sector address (ccchss) of the utility. When it is loaded, the 
utility prints this message at the operator station: 



RDOOOI DISKETTE TO PRINTER DUMP STARTED 



The utility prints this prompt for the location of the data file information to be dumped 
from the diskette : 



RDIOOA DISK AREA- 



Enter the requested information in this form: 



ddd,ccchss,ccchss 



where: 

ddd = the diskette device address in decimal 

ccchss,ccchss = the starting and ending sector addresses 

delimiting the location of the data file information to be dumped 

from the diskette. 
If there are no errors, the utiUty dumps the requested data file information on the 
printer. You may stop the dump by causing an interrupt from the operator station. To do 
this, hold down the CTRL key, then press the A key. This causes the dump to stop at the 
end of a print line, print an abnormal recycle message, and reprompt for new input. Once 
the dump operation is finished, a completion message is written at the operator station 
and followed by a prompt for the next source data file information to be dumped. The 
utiUty continues in this mode until you terminate it in some manner (for example, by 
pressing the LOAD key). 



THE OUTPUT YOU RECEIVE 



This utility dumps the contents of a specified data file from the diskette on the printer. 
The dump is in hexadecimal with columns of EBCDIC translation to the right of the page 
and is formatted by sectors in the following manner: 



ccchss xxxx 


xxxx<- - - 


-12 words - 


— >xxxx 


xxxx 


yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy 


xxxx 


xxxx<- - - 


-12 words - 


- - ->xxxx 


xxxx 


yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy 


xxxx 


xxxx<- - - 


-12 words - 


— >xxxx 


xxxx 


yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy 


xxxx 


xxxx< 


- 12 words - 


— >xxxx 


xxxx 


yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy 



where: 

ccchss = 

xxxx = 

yyyy = 



the sector address of the data on the diskette 
the contents of the diskette sector in hexadecimal 
the contents of the diskette sector in EBCDIC 
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I If the utility encounters a deleted header record on cylinder sectors 8-26, head or 
sectors 1-26, head 1, it prints the message PHYSICAL RECORD HAS BEEN 
LOGICALLY DELETED on the printer. The message is preceded by the ccchss address. 
When the dump is finished, the utility issues this mftssagft at the operator station: 



Rr>q01I 1DISKETTE^::T^ 



It then reissues the DISK AREA= prompt. 



HOW TO HANDLE ERRORS 



EXAMPLE 



If the utility encounters a recoverable error, it prints an error message and reissues the 
prompt. Recoverable errors are : 

• Response to prompt does not have three parameters 

• Invalid device address 

• Device at the specified device address not a diskette device 

• Invalid sector address 

• Starting sector address greater than ending sector address 

If the utility encounters an unrecoverable diskette device I/O error, it abnormally 
terminates and reissues the DISK AREA= prompt. If the utility encounters an 
unrecoverable operator station or printer I/O error, it terminates. 



The following is an example of a dump from the diskette on the printer. The diskette 
device address is 002 with a starting sector address of 030015 and an ending sector 
address of 030016. 



Operator Station Printout 


Explanation 


IP100AEXEC= 

RD 

RDOOOI DISKETTE TO PRINTER 
DUMP STARTED 
RDIOOA DISK AREA= 

F02,030015,030016 

RD004A INVALID DEVICE ADDRESS- 
NON-DECIMAL DIGIT 
RDIOOA DISK AREA= 

002,030015,030016 

RDOOII DISKEITE TO PRINTER 

DUMP COMPLETED 

RDIOOA DISK AREA= 


The loader issues a request for the program that is 

to be executed. 

You enter the name of the Diskette to Printer 

Dump utility. 

The Diskette to Printer dump has started. 

Hie utility prompts for the disk sectors to be 

dumped. 

You enter the device address, starting sector 

address, and ending sector address for the dump. 

The device address is incorrect. 

The utility reissues a prompt for the disk sectors to 

be dumped. 

You enter the correct address for the disk. 

The dump was successfully completed. 

The utihty prompts for the next data file to be 
dumped. 
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Disk To Printer Dump (FD) 

WHAT THIS UTILITY DOES 

This utility dumps the contents of a specified data file from the disk on the printer. 



HOW TO USE IT 



Press the LOAD key. After the EXEC= message is printed at the operator station, enter 
either FD or the starting sector address (ccchss) of the utility. When it is loaded, the 
utility prints this message at the operator station : 



FDOOOI DISK TO PRINTER DUMP STARTED 



The utility prints this prompt for the location of the data file information to be dumped 
from the disk: 



FDIOOA DISK AREA= 



Enter the requested information in this form: 



ddd,ccchss,ccchss 



where: 

Iddd = the disk device address in decimal 

ccchss,ccchss = starting and ending sector addresses delimiting the location of the 

data file information to be dumped from the disk 
If there are no errors, the utility dumps the requested data file information on the 
printer. You may stop the dump by causing an interrupt from the operator station. To do 
this, hold down the CTRL key, then press the A key. This causes the dump to stop at the 
end of a print line, print an abnormal recycle message, and reprompt for new input. Once 
the dump operation is completed, a completion message is written at the operator station 
and followed by a prompt for the next source data file information to be dumped. The 
utility continues in this mode until you terminate it in some manner (for example, by 
pressing the LOAD key). 



THE OUTPUT YOU RECEIVE 



This utility dumps the contents of a specified data file on the printer. The dump is in 
hexadecimal with columns of EBCDIC translation to the right of the page and is 
formatted by sectors in the following manner: 



xxxx xxxx< — 12 words— >xxxx xxxx yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy 

xxxx xxxx< — 12 words— >xxxx xxxx yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy 

xxxx xxxx<— 12 words— >xxxx xxxx yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy 

xxxx xxxx< — 12 words— >xxxx xxxx yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy 

xxxx xxxx< — 12 words- >xxxx xxxx yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy 

xxxx xxxx< — 12 words— >xxxx xxxx yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy 

xxxx xxxx< — 12 words— ■>xxxx xxxx yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy 

xxxx xxxx< — 12 words— >xxxx xxxx yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy 
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where: 

ccchss = the sector address of the data file on the disk 

xxxx = the contents of the disk sector in hexadecimal 

yyyy = the contents of the disk sector in EBCDIC 

When the dump is finished, the utility issues this message at the operator station: 



FDOOIA DISK TO PRINTER DUMP COMPLETED 



It then reissues the DISK AREA= prompt. 



HOW TO HANDLE ERRORS 



EXAMPLE 



If ike utility encounters a recoverable error, it prints an error message and reissues the 
prompt. Recoverable errors are: 

• Response to the prompt does not have three parameters 

• Invalid device address 

• Device at specified device address not disk device 

• Invalid sector address 

• Starting sector address greater than ending sector address 

If the utility encounters an unrecoverable disk I/O error, it abnormally terminates and 
reissues the DISK AREA= prompt. If the utility encounters an unrecoverable operation 
station or printer I/O error, it terminates. 



The following is an example of a dump from the disk on the printer. The disk device 
address is 003, with a starting sector address of 200130 and an ending sector address of 
200131. 



Operator Station Printout 


Explanation 


IP100AEXEC= 


The loader issues a request for the program that is 




to be executed. 


FD 


You enter the name of the Disk to Printer Dump 




utiUty. 


FDOOOI DISK TO PRIN'lER DUMP 


The Disk to Printer Dump utility has started. 


STARTED 




FDIOOADISK AREA= 


The utility prompts for the disk sectors to be 




dumped. 


F03,200130,200131 


You enter device address, starting sector address. 




and ending sector address for the dump. 


FD004A INVALID DEVICE ADDRESS- 


"Die device address is incorrect. 


NON DECIMAL DIGIT 




FDIOOA DISK AREA= 


The utility reissues a prompt for the disk 




sectors to be dumped. 


003,200130,200131 


You enter the correct address for the disk. 


FDOOII DISK TO PRINTER DUMP 


The dump was successfully completed. 


COMPLETED 




FDIOOA DISK AREA= 


The utility prompts for the next data file to be 




dumped. 
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Diskette Patch (TR) 

WHAT THIS UTILITY DOES 



This utility applies a patch which you enter at the operator station to a specified area on 
the diskette. 



HOW TO USE IT 



Press the LOAD key. After the EXEC= message is printed at the operator station, enter 
either TR or the starting sector address (ccchss) of this utility. When it is loaded, the 
utility responds with: 



TROOOI DISKETTE PATCH STARTED 



The utility issues this prompt for the location on the diskette you want to patch: 



TR200A PATCH ARBA^ 



Enter the requested information in the following form: 



ddd,ccchss,bbb,nnn 



where: 

ddd = the diskette device address in decimal, in the range 0—127 

ccchss = the sector address of the area to be patched 

bbb = the byte displacement in decimal, within the sector, where you want 

the patch to start 
mm = the number of bytes you want displayed for verification before the 

patch is applied 

This number must not exceed 128. All bytes printed for verification 

must be within the boundaries of the sector you specified; that is, 

the sum of bbb + nnn must be less than 129. 
If there are no errors, the utiUty prints the bytes that you requested for verification and 
then prints this prompt on the next line : 



TR201A REPLACEMENT DATA» 



If the bytes printed for verification do not begin with the bytes you want to patch, enter 
this response : 



NONE 



The utility responds: 



TROOl I DISKETTE PAtCH COMPLETED 



It then reissues the PATCH AREA= prompt. 
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If the bytes printed for verification begin with the ones you want to patch, enter the 
patch in the following form: 



hhhh hhhh hhhh 



where: 

hhhh hhhh hhhh ... are groups of four hexadecimal characters, separated by blanks 

The length of the patch must be in the range of 1 to 128 bytes. 
The entire patch must be within the boundaries of the sector you 
specified. Note that the length of the patch does not have to 
equal the value you specified for nnn (the byte verification 
count). 

If there are no errors, the patch is applied. 

The utility responds with: 



TROOII DISKETTE PATCH COMPLETED 



The utility issues the completion message which is followed by the prompt for the next 
patch. The utility continues in this mode until you terminate it by pressing the LOAD 
key. 



THE OUTPUT YOU RECEIVE 

The output from this utility are prompt messages from the utility and the data for the 
requested patch to diskette. 



HOW TO HANDLE ERRORS 



If a recoverable error occurs, the utility prints an appropriate error message and then 
reissues the prompt. Recoverable errors are: 

• Syntax error in your response to a prompt 

• Device at specified device address not a diskette 

• Sector address not a valid address for diskette 

• Displacement not within the boundaries of the sector you specified 

• Number of bytes to be displayed either exceeds 128 or less than or equal to zero 

If an unrecoverable diskette I/O error occurs, the utility abnormally terminates. A 
terminal error occurs when an I/O error prevents the utility from printing a message at 
the operator station. 
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EXAMPLE 



The following example shows what happens when you apply a patch to the diskette. 



Operator Station Printout 


Explanation 


IP100AEXEC= 


The loader issues a request for the program that 
is to be executed. 


TR 


You enter the iiame of the Diskette Patch utility. 


TROOOI DISKETTE PATCH STARTED 


The Diskette Patch utility has started. 


TR200 A PATCH AREA= 


The utility issues a request for the address of 
the location to be patched. 


02, 003003, 24, 08 


You enter the device address, sector address, 
byte displacement, and byte verification count. 


TR003A INVALID DEVICE ADDRESS- 
3 DIGITS REQUIRED 


The device address is incorrect. 


TR200A PATCH AREA= 


The utility reissues the prompt for the address 
of the location to be patched. 


002, 003003, 24, 08 


You enter the correct device address, sector 
address, byte displacement, and byte verifica- 
tion count. 


TRIOI A INVALID DISPLACEMENT- 
3 DIGITS REQUIRED 


The byte displacement is incorrect. 


TR200A PATCH AREA= 


The utility reissues the prompt for the address 
of the location to be patched. 


002,003003, 024, 08 


You enter the device address, sector address, 
conect byte displacement, and byte verifica- 
tion count. 


TR105A INVALID BYTE VERIFICATION 
COUNT- 3 DIGITS REQUIRED 


The byte verification count is incorrect. 


TR200A PATCH AREA= 


The utility reissues the prompt for the address 
of the location to be patched. 


002, 003003, 024, 008 


You enter the device address, sector address, 
byte displacement, and the correct byte veri- 
fication count. 


OOOA 123B 0101 AOOC 


These are the 8 bytes requested for verification. 


TR201A REPLACEMENT DATA= 


The utility issues a request for you to enter a 
patch or cancel this particular patch operation. 


NONE 


No patch is to be applied. 


TROOII DISKETTE PATCH COMPLETED 


The patch cycle was successfully completed. 


TR200A PATCH AREA= 


The utility prompts for the next patch cycle. 
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Disk Patch (TF) 

WHAT THIS UTILITY DOES 



This utility applies a patch which you enter at the operator station to a specified area on 
the disk. 



HOW TO USE IT 



Press the LOAD key. After the EXEC= message is printed at the operator station, enter 
either TF or the starting sector address (ccchss) of this utility. When it is loaded, the 
utility issues this message: 



TFOOOI DISK PATCH STARTED 



The utility issues this prompt for the location on the disk you want to patch: 



TF200A PATCH AREA^ 



Enter the requested information in the following form: 



ddd,ccchss,bbb,nnn 



where: 

ddd 



= the disk device address in decimal in the range 0—255 



ccchss = the sector address of the area to be patched 

bbb = the byte displacement in decimal, within the sector, where you want 

the patch to start 
nnn = the number of bytes you want displayed for verification before the 

patch is applied 

This number must not exceed 256. All bytes printed for verification 

must be within the boundaries of the sector you specified; that is, 

the sum of bbb + nnn must be less than 257. 
If there are no errors, the utiUty prints the bytes that you requested for verification and 
then prints this prompt on the next line: 



TF201A REPLACEMENT DATA= 



If the bytes printed for verification do not begin with the bytes you want to patch, enter 
this response: 



NONE 



The utiUty responds with: 



TFOOll DISK PATCH COMPLETED 
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It then reissues the PATCH AREA= prompt. If the bytes printed for verification begin 
with the ones you want to patch, enter the patch in the following form: 



hhhh hhhh hhhh 



where: 

hhhh hhhh hhhh .... are groups of four hexadecimal characters, separated by blanks 

The length of the patch must be in the range of 1 to 256 bytes. 
The entire patch must be within the boundaries of the sector you 
specified. Note that the length of the patch does not have to 
equal the value you specified for nnn (the byte verification 
count). 

If there are no errors, the patch is applied. 

The utihty responds with: 



TFOOII DISK PATCH COMPLETED 



The utihty issues the completion message which is followed by the prompt for the next 
patch. The utiUty continues in this mode until you terminate it by pressing the LOAD 
key. 



THE OUTPUT YOU RECEIVE 

The output from this utility are prompt messages from the utility and the data for the 
requested patch to diskette. 



HOW TO HANDLE ERRORS 



If a recoverable error occurs, the utiUty prints an appropriate error message and then 
reissues the prompt. Recoverable errors are: 

• Syntax error in your response to a prompt 

• Device at specified device address not a disk 

• Sector address not a valid disk address 

• Displacement not within the boundaries of the sector you specified 

• Number of bytes to be displayed exceeds 256 

If an unrecoverable disk I/O error occurs, the utiUty abnormally terminates. A terminal 
error occurs when an I/O error prevents the utihty from printing a message at the 
operator station. 
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EXAMPLE 



The following example shows what happens when you apply a patch to the disk. 



Operator Station Printout 


Explanation 


IPIOO EXEO 


The loader issues a request for the program that is 




to be executed. 


TF 


You enter the name of the Disk Patch utility. 


TFOOOI DISK 


The Disk Patch utility has started. 


PATCH STARTED 




TF200A PATCH AREA= 


The utility issues a request for the address of the 




location to be patched. 


03,003003,24,08 


You enter the device address, sector address, byte 




displacement, and the byte verification count. 


TF003A INVALID DEVICE ADDRESS- 


Ihe device address is incorrect. 


3 DIGITS REQUIRED 




TF200A PATCH AREA= 


The utility reissues the prompt for the address of 




the area to be patched. 


003,003003,24,08 


You enter the correct device address, sector 




address, byte displacement, and the byte 




verification count. 


TFIOIA INVALID DISPLACEMENT-3 


The byte displacement is incorrect. 


DIGITS REQUIRED 




TF200A PATCH AREA= 


The utility reissues the prompt for the address of 




the area to be patched. 


003,003003,024,08 


You enter the device address, sector address, 




correct byte displacement, and the byte 




verification count. 


TF105A INVALID BYTE VERIFICATION 


Ihe byte verification count is invalid. 


COUNT-3 DIGITS REQUIRED 




TF200A PATCH AREA= 


The utility reissues the prompt for the address of 




the area to be patched. 


003,003003,024,008 


You enter the device address, sector address, byte 




displacement, and the correct byte verification 




count. 


000A123B0101 AOOC 


These are the 8 bytes requested for verification. 


TF201 A REPLACEMENT DATA= 


The utility issues a request for you to enter a patch 




or cancel this particular patch operation. 


NONE 


No patch is applied. 


TFOOII DISK 


The patch cycle was successfully completed. 


PATCH COMPLETED 




TF200A PATCH AREA= 


The utUity prompts for the next patch cycle. 
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storage To Diskette Dump (SI) 

WHAT THIS UTILITY DOES 

When you press the LOAD key on the console, the hardware loads this utility into main 
storage from a pre-built dedicated diskette. The utility then dumps the contents of 
storage to that same diskette. 

HOW TO CREATE THE DISKETTE 

You must create a special diskette for the storage to diskette dump. 

Locate the ccchss of the program SI on the system verification listing. Using the disk to 
diskette copy program, copy the program SI to the dedicated diskette. You must start 
the copy 1 disk sector beyond the beginning of the program to remove the header record. 
SI must be placed on the diskette at cylinder 0, head 0, sectors 1 and 2. 

Next, copy the second phase of the program to the dedicated diskette. Locate the 
ccchss of the program S2 on the system verification listing. Using the disk to diskette 
copy program, copy the program S2 to cylinder 1, head 0, sectors 1 through 26 of the 
diskette. Once this is done, the diskette is ready for you to use. 



HOW TO USE IT 



Mount the special storage to diskette dump on the fixed address diskette device and set 
the switch to alternate. After you press the LOAD key, the dump starts at storage address 
256 and continues until all storage has been dumped. The first 256 bytes are destroyed 
by the loading of the dump program. Also, on level 0, the lAR is altered by the dump. 



THE OUTPUT YOU RECEIVE 



The output from this utiUty is the storage dump onto the diskette. The HDRl record 
looks like this: 
bytes 00-03 HDRl 
I 05-21 data set identifier indicating that this is a dump data set (SSRISTED) 

22-26 the block length, which is 1 28 

28—32 the starting address of the dump, which is cylinder 2, head 0, sector 
1 

This area appears in cchss format and contains 02001. 
33 the physical record length, which is 128 

I 34—38 the ending address of the dump, which the utility provides in cchss 

format 
74—78 the end of data address, which is updated by the dump program 
This is the format of the dump. 
Beginning at cyUnder 2, head 0, sector 1 : 
I • JAR, general-purpose register, AKR and LSR for each level 
• The address in storage where the dump begins 
Beginning at cyUnder 3, head 0, sector 1 is the storage dump. 
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HOW TO HANDLE ERRORS 



EXAMPLE 



If the utility encounters any recoverable errors during the dump, the utiUty tries to 
recover. However, if the error is unrecoverable, the processor stops. 



The following is an example of building a diskette for the Storage to Diskette Dump 
utility. 



Operator Station Printout 


Explanation 


IP100AEXEC= 


The loader issues a request for the program that 
is to be executed. 


ER 


You enter the name of the Disk to Diskette Copy 
utility. 


FROOII DISK TO DISKETTE COPY 
STARTED 


The Disk to Diskette Copy utility has started. 


FRIOOA FROM DATA AREA= 


The utility prompts for the source data file 
information. 


003, 002143, 002143 


You enter the device address and the starting 
sector address +1 of the program SI. This re- 
moves the header record from the diskette 
bootstrap. Only one disk sector is copied. 


FR200A TO DATA AREA= 


The utility issues this prompt for the destination 
data file information. 


002, 000001, 000002 


You enter the device address and the starting 
sector address where the bootstrap must reside 
on cylinder 0, head 0, sectors 1 and 2. 


FR099I LAST SECTOR WRITTEN IS 
000002 


The utility prints the address of the last sector 
written on the diskette. 


FROOII DISK TO DISKETTE COPY 
COMPLETED 


The copy was successfully completed. 


FRIOOA FROM DATA AREA= 


The utility prompts for the soiurce data fUe 
information. 


003, 002144, 002152 


You enter the device address and the starting 
sector address of the program S2. This copy 
must include the header and the program. 


FR200A TO DATA AREA= 


The utility issues this prompt for the destination 
data file information. 


002,001001,001026 


You enter the device address and the starting 
sector address where the Phase 2 of the program 
must reside on cylinder 1, head 0, sectors 1—26. 


FR099I LAST SECTOR WRITTEN IS 
001026 


The utility prints the address of the last sector 
written on the diskette. It may be something 
less than sector 26. 


FROOII DISK TO DISKETTE COPY 
COMPLETED 


The copy was successfully completed. 


FRIOOA FROM DATA AREA= 


The utility prompts for a new source data file 
for the next copy operation. 
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Storage To Printer Dump (PI) 

WHAT THIS UTILITY DOES 

When you press the LOAD key on the console, the hardware loads this utility from a 
dedicated pre-built diskette. The utility then dumps the contents of storage on the 
printer. 

HOW TO CREATE THE DISKETTE 

You must create a special diskette for the storage to diskette dump. 

Locate the ccchss of the program PI on the system verification listing. Using the disk to 
diskette copy program, copy the program PI to the dedicated diskette. You must start 
the copy 1 disk sector beyond the beginning of the program to remove the header record. 
PI must be placed on the diskette at cylinder 0, head 0, sectors 1 and 2. 

Next, copy the second phase of the program to the dedicated diskette. Locate the 
ccchss of the program P2 on the system verification Usting. Using the disk to diskette 
copy program, copy the program P2 to cylinder 1, head 0, sectors 1 through 26 of the 
diskette. Once this is done, the diskette is ready for you to use. 



HOW TO USE IT 



Set the IPL switch to alternate (diskette) and mount the pre-built storage to printer dump 
on the fixed address diskette device. After you press the LOAD key, the level status 
blocks for all levels are printed. No messages are printed at the operator station. 

Note. If the full function console is available and the system is in the diagnostic mode, 
the program stops and allows you to enter in Rl a hex starting address of XOIOO' or 
higher and to enter in R2 a hex ending address; otherwise, the dump starts at decimal 
location 256 and continues until the end of storage. On level 0, the lAR is altered by the 
dump. 

When the system is in the diagnostic mode and a selected area has been printed, the 
program stops allowing a new entry to be made in Rl and R2. At any time an area is 
being printed, press the console INTERRUPT key to interrupt the program and select a 
new area to be dumped. The program wiU continue to wait for additional input until 
terminated by hitting the RESET button or IPL LOAD button. 
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THE OUTPUT YOU RECEIVE 

The output from this utiHty is the storage dump on the printer. The data is dumped on 
the printer in the following format: 



n i i i i kkkk 1111 xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx 

aaaa hhhh hhhh <- 12 words- -> hhhh hhhh eeee<24 char>eeee 

aaaa hhhh hhhh <--- 12 words- > hhhh hhhh eeee<24 chaT)eeee 



where: 

aaaa = the address of the leftmost byte of storage 

eeee = the valid EBCDIC character or a period for an invalid character 

hhhh = the contents of storage 

iiii = the contents of the I AR 

kkkk = the contents of the AKR 

1111 = the contents of the LSR 

n = the interrupt level number 

The number n and the line to the right of the n are printed four 

times— once for each level 
xxxx = the contents of the general-purpose rigisters 

The storage dump will always start on a doubleword boundary. 

Note. This program uses cylinder 3, head 0, sectors 1 thru 26 as a temporary work area 
on the IPLed diskette. 



6-20 GC34-0070 



HOW TO HANDLE ERRORS 



EXAMPLE 



If it encounters any errors during the dump, the utiUty tries to recover. However, if the 
error is unrecoverable, the processor stops. 



The following is an example of building a diskette for the Storage to Printer Dump 
utiUty. 



Operator Station Printout 


Explanation 


IPIOOA EXEC= 


The loader issues a request for the program that 
is to be executed. 


FR 


You enter the name of the Disk to Diskette Copy 
utility. 


FROOII DISK TO DISKETTE COPY 
STARTED 


The Disk to Diskette Copy utility has started. 


FRIOOA FROM DATA AREA= 


The utility prompts for the source data file 
information. 


003,002128,002128 


You enter the device address and the starting 
sector address +1 of the program PI. This re- 
moves the header record from the diskette 
bootstrap. Only one disk sector is copied. 


FR200A TO DATA AREA= 


The utility issues tliis prompt fro the destination 
data file information. 


002, 000001, 000002 


You enter the device address and the starting 
sector address where the bootstrap must reside 
on cylinder 0, head 0, sectors 1 and 2. 


FR099I LAST SECTOR WRITTEN IS 
000002 


The utility prints the address of the last sector 
written on the diskette. 


FROOII DISK TO DISKETTE COPY 
COMPLETED 


The copy was successfully completed. 


FRIOOA FROM DATA AREA= 


The utility prompts for the source data file 
information. 


003, 002129, 002141 


You enter the device address and the starting 
sector address of the program P2. This copy 
must include the header and the program. 


FR200A TO DATA AREA= 


The utility issues this prompt for the destination 
data file information. 


002,001001,001026 


You enter the device address and the starting 
sector address where the Phase 2 of the program 
must reside on cylinder 1, head 0, sectors 1-26. 


FR099I LAST SECTOR WRITTEN IS 
001026 


The utility prints the address of the last sector 
written in the diskette. It may be something less 
than sector 26. 


FROOII DISK TO DISKETTE COPY 
COMPLETED 


The copy was successfully completed. 


FRIOOA FROM DATA AREA= 


The utility prompts for a new source data file 
for the next copy operation. 
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Chapter 7. Error Log (EL) 



WHAT THIS PROGRAM DOES 

The purpose of the error log program is to record machine and program errors such as 
program checks, I/O errors, machine checks, soft-exception checks, and null interrupts. 
The error log program will: 

• Log the error in two buffers that you define. 

• Format the log entry so that you can, with your own routine, either list the record on 
a print device or write it to a disk or diskette. 

• Format the log entry into binary. 



Input to $ELERLOG 



$ELERLOG 



Output 



User Routine 



Error 
Log 

Control 
Block 



Parameter List 



EBCDIC 
Buffer 




Address of Error 
Log Control Block 



Address of EBCDIC 
Buffer 



Address of Binary 
Buffer 



Error Indicator 



$ELERLOG 
Program 



EBCDIC Buf- 
fer in print- 
able hexa- 
decimal 


i 




i 


Routine to 
write log 
to disk or 
print device 


and 


S '"'r 


Binary Buf- 
fer in 
Binary 


n 


1 






You must set up an error log control block, which will contain information regarding the 
error. Then define two buffers: one to hold the formatted log in hexadecimal EBCDIC 
characters; and, one to hold the formatted log in binary. The error indicator is required 
to specify the type of error being logged, and a parameter list must point to the locations 
of the first three items and must specify the error indicator. 
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HOW TO USE IT 



Error Indicators 



Do a branch and link instruction to $ELERLOG, storing your return address in register 7, 
after link-editing the error log program to your own program. (To locate the error log 
program, see "Automatic System Build (SB)" in Chapter 2.) Register must point to a 
word-aligned parameter list with the following information: 

o The address of the error log control block. 

« The address of the EBCDIC buffer, which will hold the formatted error. 

• The address of the binary buffer, which will hold the formatted error in binary. 

• The error indicator, which must specify the type of error encountered. 

Only one error can be logged in the message area at a time, so you must store the 
message on a disk or diskette or write it to a printer before calling the error log program 
again. Since the error log program must use some privileged instructions, it must run in 
supervisor state. 



The format of the error log control block and the completed buffers will vary, depending 
on the error type encountered. Use the following identifying letters to specify the error 
type to the error log program in the error log control block: 

DE = specifies a device error 

TO = specifies an I/O timeout 

MC = specifies a machine check 

PC = specifies a program check 

SC = specifies a soft-exception check 

NI = specifies a null interrupt 



7-2 GC34-007O 



Error Log Control Block 



DE or TO Error Indicators: 



MC, PC, or SC Error Indicators: 



You must set up the error log control block in the following three formats and make 
available the information for the items listed. 



Displacement 


Size in 
bytes 


F/eW «ame 


Contents 


Dec. 


Hex. 








2 


Interrupt Level 


The interrupt level that is assigned 
to the I/O device with program 
control. 


2 


2 


2 


Device ID 


Specifies the ID of the device on 
which the error occurred. 


4 


4 


1 


Retry Count 


Specifies the number of times the 
error has been tried. 


5 


5 


1 


Blank Space 


Necessary to start IDCB on even byte. 


6 


6 


2 


Address of IDCB 


Specifies the address in storage of the 
Immediate Device Control Block. 


8 


8 


1 


010 Condition Code 


Specifies the condition code follow- 
ing the command Operate I/O 
instruction, 


9 


9 


1 


Interrupt Condition 
Code 


Specifies the condition code when 
the interrupt was accepted. 


10 


A 


1 


ISB 


Specifies the Interrupt Status Byte. 


11 


B 


1 


Number of CSSW's 


Specifies the number of cycle steal 
status words for the device named 
in Device ID. 


12 


C 


2 


CSSWl 


Fkst Cycle Steal Status Word. 


14 


E 


2 


CSSW2 


Second Cycle Steal Status Word. 


16 


10 


2 


CSSW3 


Third Cycle Steal Status Word. 


18 


12 


2 


CSSW4 


Fourth Cycle Steal Status Word. 


20 


14 


2 


CSSW5 


Fifth Cycle Steal Status Word. 



Displacement 


Size in 
bytes 


Field name 


Contents 


Dec. 


Hex. 








2 


Interrupt Level 


The interrupt level that is assigned 
to the I/O device vidth program 
control. 


2 


2 


2 


Address of LSB 


The address of the Level Status Block. 


4 


4 


2 


PSW 


The Program Status Word. 


6 


6 


2 


Error Address 


The address when the error was 
encountered. 


8 


8 


1 


Active Address Key 


The address key in use when the error 
is encountered (4955 only). 
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NI Error Indicator: 



Displacement 


Size in 
bytes 


Field name 


Contents 


Dec. 


Hex. 




2 




2 


2 
2 


Interrupt Level 
Interrupt ID 


The interrupt level that is assigned 
to the I/O device with program 
control. 

Consists of an interrupt information 
byte and the device address. 



See IBM Series/l Model 5 4955 Processor and Processor Features Description, GA34-0021 or IBM 
Series/l Model 3 4953 Processor and Processor Features Description, GA34-0022 for extended 
discussions of the items to be specified above. 



EBCDIC Buffer 



Binary Buffer 



The EBCDIC buffer will hold the formatted error when the error log program has 
completed processing. This buffer must be word aligned and must have enough space to 
contain the largest formatted error — 368 bytes. 



The binary buffer will hold the formatted error in binary form. This buffer must be word 
aligned and must have enough space to contain the largest formatted error — 124 bytes. 



THE OUTPUT YOU RECEIVE 

The error log program will extract the data it required from the error log control block. 
It then formats the data into hexadecimal characters in one of the following forms so 
that, with a program you provide or with a utility, you can take the data from the 
EBCDIC buffer and list the records using a printer device, or you can write the records 
on a disk or diskette. 
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EBCDIC Buffer Output 
DE or TO Error Indicators: 



Displacement 
in bytes 


Size in 
bytes 


F/eW name 


Contents 


Dec. 


Hex. 








7 


Reserved Zeros 


Non-significant zeros. 


7 


7 


1 


Blank Space 


- 


8 


8 


1 


Interrupt Level 


The interrupt level that is assigned 
to the I/O device with program 
control. 


9 


9 


1 


Blank Space 


- 


10 


A 


4 


AKR (Address Key 
Register) 


The contents of the Address Key 
Register (4955 only). 


14 


E 


1 


Blank Space 


- 


15 


F 


4 


Device ID 


Specifies the ID of the device on 
which the error occurred. 


19 


13 


1 


Blank Space 


- 


20 


14 


3 


Retry Count 


Specifies the number of times the 
error has been tried. 


23 


17 


1 


Blank Space 


- 


24 


18 


8 


IDCB 


Contains an I/O command that 
describes the specific nature of the 
I/O operation. 


32 


20 


1 


Blank Space 


- 


33 


21 


1 


010 Condition Code 


Specifies the condition code follow- 
ing the command Operate I/O 
instruction. 


34 


22 


1 


Interrupt Condition 
Code 


Specifies the condition code when 
the interrupt was accepted. 


35 


23 


2 


ISB 


Specifies the Interrupt Status Byte. 


37 


25 


1 


Blank Space 


- 


38 


26 


2 


Number of CSSW's 


The number of Cycle Steal Status 
Words. 


40 


28 


1 


Blank Space 


- 


41 


29 


4 


CSSWl 


First Cycle Steal Status Word. 


45 


2D 


1 


Blank Space 


- 


46 


2E 


4 


CSSW2 


Second Cycle Steal Status Word. 


50 


32 


1 


Blank Space 


- 


51 


33 


4 


CSSW3 


Third Cycle Steal Status Word. 


55 


37 


1 


Blank Space 


- 


56 


38 


4 


CSSW4 


Fourth Cycle Steal Status Word. 


60 


3C 


1 


Blank Space 


- 


61 


3D 


4 


CSSW5 


Fifth Cycle Steal Status Word. 
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DE or TO Indicators Continued": 





Displacement 
in bytes 


Size in 
bytes 


Field name 


Contents 




Dec. 


Hex. 




65 


41 


1 


Blank Space 


- 






66 

78 


42 
4E 


12 
4 


Descriptive Text 
DCB Word 1 


"I/O Timeout" or "Device Error" 

Device-dependent control word- 
see individual device publication 
for definition. 










82 


52 


1 


Blank Space 


- 






83 


53 


4 


DCB Word 2 


Device-dependent control word- 
see individual device publication 
for definition. 






87 


57 


1 


Blank Space 


- 






88 


58 


4 


DCB Word 3 


Device-dependent control word- 
see individual device publication 
for definition. 






92 


5C 


1 


Blank Space 


- 


Repeated for 
each DCB- 
to maximum 
offiveDCBs. 




93 

97 
98 


5D 

61 
62 


4 

1 

4 


DCB Word 4 

Blank Space 
DCB Word 5 


Device-dependent control word- 
see individual device publication 
for definition. 

Device-dependent control word- 
see individual device publication 
for definition. 






102 


66 


1 


Blank Space 


- 






103 


67 


4 


DCB Word 6 


Device-dependent control word- 
see individual device publication 
for definition. 






107 


6B 


1 


Blank Space 


- 






108 


6C 


4 


DCB Word 7 


Device-dependent control word- 
see individual device publication 
for definition. 






112 


70 


1 


Blank Space 


- 






113 


71 


4 


DCB Word 8 


Device-dependent control word- 
see individual device publication 
for definition. 






117 


75 


1 


Blank Space 


- 






118 


76 


4 


Descriptive Text 


"Device Error - DCB" 




>- 
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MC, PC, or SC Error Indicators: 



Displacement 
in bytes 


Size in 
bytes 


Field name 


Contents 


Dec. 


Hex. 








7 


Reserved Zeros 


Non-significant zeros. 


7 


7 


1 


Blank Space 


- 


8 


8 


1 


Interrupt Level 


The interrupt level that is 
assigned to the I/O device 
with program control. 


9 


9 


1 


Blank Space 


- 


10 


A 


4 


AKR (Address Key 
Register) 


The contents of the Address Key 
Register (4955 only). 


14 


E 


1 


Blank Space 


- 


15 


F 


4 


PSW 


The Program Status Word. 


19 


13 


1 


Blank Space 


- 


20 


14 


4 


Error Address 


The address when the error was 
encountered. 


24 


18 


1 


Blank Space 


- 


25 


19 


1 


Active Address 


The address key in use when the 
error is encountered (4955 only). 


26 


lA 


1 


Blank Space 


- 


27 


IB 


4 


lAR 


The 16-bit register that holds the 
main storage address used to fetch 
an instruction. 


31 


IF 


1 


Blank Space 


- 


32 


20 


4 


LSR 


The Level Status Register. 


36 


24 


1 


Blank Space 


- 


37 


25 


20 


Descriptive Text 


"Program Check", "Machine Check", 
or "Soft Exception Check". 



NI Error Indicator: 



Displacement 
in bytes 


Size in 
bytes 


Field name 


Contents 


Dec. 


Hex. 










Reserved Zeros 


Non-significant zeros. 


7 


7 




Blank Space 


- 


8 


8 




Interrupt Level 


The interrupt level that is assigned 
to the I/O device with program 
control. 


9 


9 




Blank Space 


- 


10 


A 




AKR (Address Key 
Register) 


The contents of the Address Key 
Register (4955 only). 


14 


E 




Blank Space 


- 


15 


F 




ISB 


Specifies the Interrupt Status Byte. 


17 


11 




Blank Space 


- 


18 


12 




Device Address 


The I/O device address. 


20 


14 




Blank Space 


- 


21 


15 


14 


Descriptive Text 


"Null Interrupt". 



See IBM Series! 1 Model 5 4955 Processor and Processor Features Description, GA34-0021 or IBM 
Series/l Model 3 4953 Processor and Processor Features Description, GA34-0022 for extended 
discussions of the items to be specified above. 
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Binary Buffer Output 
DE or TO Error Indicators: 



Displacement 
in bytes 


Size in 
bytes 


Field name 


Contents 


Dec. 


Hex. 








6 


Reserved Zeros 


Non-significant zeros. 


6 


6 


2 


AKR (Address Key 
Register) 


The contents of the Address Key 
Register (4955 only). 


8 


8 


6 


Reserved Zeros 


Non-significant zeros. 


14 


E 


1 


Interrupt Level 


The interrupt level that is assigned 
to the I/O device with program 
control. 


15 


F 


2 


Device ID 


Specifies the ID of the device on 
which the error occurred. 


17 


11 


4 


IDCB 


Contains an I/O command that 
describes the specific nature of 
the I/O operation. 


21 


15 


1 


Reserved Zeros 


Non-significant zeros. 


22 


16 


1 


Retry Count 


Specifies the number of times the 
error has been tried. 


23 


17 


1 


010 Condition 
Code 


Specifies the condition code 
following the command Operate 
I/O instruction. 


24 


18 


1 


Interrupt Condition 
Code 


Specifies the condition code when 
the interrupt was accepted. 


25 


19 


1 


ISB 


Specifies the Interrupt Status Byte. 


26 


lA 


7 


Reserved Zeros 


Non-significant zeros. 


33 


21 


2 


CSSWl 


First Cycle Steal Status Word. 


35 


23 


2 


CSSW2 


Second Cycle Steal Status Word. 


37 


25 


2 


CSSW3 


Third Cycle Steal Status Word. 


39 


27 


2 


CSSW4 


Fourth Cycle Steal Status Word. 


41 


29 


2 


CSSW5 


Fifth Cycle Steal Status Word. 


43 


2B 


16 


DCBl 


Up to five DCBs can be chained, 
this is the first one. 


59 


3B 


16 


DCB2 


Up to five DCBs can be chained, 
this is the second. 


75 


4B 


16 


DCB3 


Up to five DCBs can be chained, 
this is the third. 


91 


5B 


16 


DCB4 


Up to five DCBs can be chained, 
this is the fourth. 


107 


6B 


16 


DCB5 


Up to five DCBs can be chained, 
this is the fifth. 
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MC, PC, or SC Error Indicators: 



NI Error Indicators: 



Displacement 
in bytes 


Size in 
bytes 


F/eW name 


Contents 


Dec. 


Hex. 








6 


Reserved Zeros 


Non-significant zeros. 


6 


6 


2 


AKR (Address Key 
Register) 


Tlie contents of the Address Key 
Register (4955 only). 


8 


8 


6 


Reserved Zeros 


Non-significant zeros. 


14 


E 


1 


Interrupt Level 


The interrupt level that is assigned 
to the I/O device with program 
control. 


15 


F 


2 


Error Address 


The address when the error was 
encountered. 


17 


11 


2 


lAR 


The 16-bit register that holds the 
main storage address used to fetch 
an instruction. 


19 


13 


2 


Active Address Key 


The address key in use when the error 
is encountered (4955 only). 


21 


15 


2 


LSR 


The Level Status Register. 


23 


17 


2 


Register 


The contents of Register 0. 


25 


19 


2 


Register 1 


The contents of Register 1. 


27 


IB 


2 


Register 2 


The contents of Register 2. 


29 


ID 


2 


Register 3 


The contents of Register 3. 


31 


IF 


2 


Register 4 


The contents of Register 4. 


33 


21 


2 


Register 5 


The contents of Register 5. 


35 


23 


2 


Register 6 


The contents of Register 6. 


37 


25 


2 


Register 7 


The contents of Register 7. 


39 


27 


2 


Reserved Zeros 


Non-significant zeros. 


41 


29 


2 


PSW 


The Program Status Word. 


43 


2A 


1 


Reserved Zeros 


Non-significant zeros. 



Displacement 
in bytes 


Size in 
bytes 


Field name 


Contents 


Dec. 


Hex. 








6 


Reserved Zeros 


Non-significant zeros. 


6 


6 


2 


AKR (Address Key 
Register) 


The contents of the Address Key 
Register (4955 only). 


8 


8 


6 


Reserved Zeros 


Non-significant zeros. 


14 


E 


1 


Interrupt Level 


The interrupt level that is assigned 
to the I/O device with program 
control. 


15 


F 


2 


Interrupt ID 


Consists of an interrupt 
information byte and the device 
address. 



See IBM Series/l Model 5 4955 Processor and Processor Features Description, GA34-0021 or IBM 
Series/I Model 3 4953 Processor and Processor Features Description, GA34-0022 for extended 
discussions of the items to be specified above. 
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HOW TO HANDLE ERRORS 

After regaining control from the error log program, your program should check the 
contents of register 0. If register equals 0, the error log program executed correctly. If 
the register contains a minus 1 , you specified an invalid error indicator in your error log 
control block input. To recover from an error, correct your input and call the error log 
program again. 
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Appendix M. Messages 



This appendix contains in numeric order within each component the following: 

• Common messages relating to normal initiation/termination and messages caused by 
incorrect user responses to common prompts which require the following input: 

ddd,ccchss,ccchss 
where: 

ddd — Device address 
ccchss — Starting sector address 
ccchss — Ending sector address 

• Unrecoverable I/O and system messages 

• Component prompt type messages and unique component messages 

• Wait code messages for the following utilities: 

IP-BOOTSTRAP/LOADER DISK 
SI -STORAGE TO DISKETTE DUMP 
PI -STORAGE TO PRINTER DUMP 

Note. You must have a full function console to see the wait code messages. These 
wait code messages appear at the end of the messages for each of the above utilities. 
All messages in this appendix are in the following format : 
idnnnc text 

id — 2-character ID of the component 

nnn — 3-digit decimal number identifying the message 
c — message type: 

A — Action; operator response to printed message required 

W — Warning; minor error detected; successful operation possible 

I — Informational; comment printed; no error 

E — Error detected; current operation terminated but program 

continues 
S — Severe Error condition; execution of program impossible 
T — Terminal Error; program aborts 



ID 


Component 


CH 


Create Diskette HDRl 


DH 


Delete Diskette HDRl 


FD 


Disk to Printer Dump 


FI 


Disk Initialization 


FR 


Disk to Diskette Copy 


IP 


IPL Bootstrap/Loader Disk 


PI 


Storage to Printer Dump 


RD 


Diskette to Printer Dump 


RF 


Diskette to Disk Copy 


RI 


Diskette Initialization 


SB 


Automatic System Build 


SF 


System Verification 


SI 


Storage to Diskette Dump 


TF 


Disk Patch 


TR 


Diskette Patch 
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COMMON MESSAGES 

idOOOI 



idOOlI 



id002E 



id003E 



id004E 



idOOSE 



id006E 



id007E 



idOlOE 



idOllE 



id0l2E 



Message and Explanation 
program name STARTED 
This message is issued after the 
processing program has been loaded 
and processing is started. 

program name COMPLETED 
This message is issued after the 
processing program has completed 
its processing. 



System Action 
None. 

Program terminates. 



INCORREGT NUMBER OF PARMS - 3 REQUIRED 

The device address, starting sector Reprompts. 

address, and ending sector address 

must be given. 

INVALID DEVICE ADDRESS - 3 DIGITS REQUIRED 
Device address must be 3 digits. Reprompts. 

INVALID DEVICE ADDRESS - NON-DECIMAL DIGIT 
Device address must be decimal Reprompts. 

digits. 



DEVICE ADDRESS OUT OF RANGE 
Device address must be within range 
of to 255. 



Reprompts. 



INCORRECT DEVICE TYPE - MUST BE DISK - AT DEVICE ddd 
Device used must be disk. Reprompts. 

INCORRECT DEVICE TYPE - MUST BE DISKETTE - AT DEVICE ddd 
Device used must be diskette. Reprompts. 

INVALID STARTING SECTOR ADDRESS - 6 DIGITS REQUIRED 
Starting sector address must be 6 Reprompts. 

digits. 

INVALID STARTING SECTOR ADDRESS - NON-DECIMAL DIGIT 

Starting sector address must be Reprompts. 

decimal digits. 

STARTING SECTOR ADDRESS OUT OF RANGE FOR DEVICE ddd 
Starting sector address range is Reprompts, 

as follows: 



DEVICE 


CCC 


H 


ss 


DISKETTE 
DISK 


000-074 
000-302 


0-1 
0-1 


1-26 
0-59 



Your Action 
None. 

None. 

Reenter the response. 

Reenter the response. 
Reenter the response. 

Reenter the response. 

Reenter the response. 
Reenter the response. 
Reenter the response. 

Reenter the response. 

Reenter the response. 



idOl 3E INVALID ENDING SECTOR ADDRESS - 6 DIGITS REQUIRED 

Ending sector address must be 6 Reprompts. 

digits. 

id014E INVALID ENDING SECTOR ADDRESS - NON-DECIMAL DIGIT 

Ending sector address must be Reprompts. 

decimal digits. 



Reenter the response. 



Reenter the response. 
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Message and Explanation System Action 

idOlSE ENDING SECTOR ADDRESS OUT OF RANGE FOR DEVICE ddd 

Ending sector address range is as Reprompts. 

follows: 



DEVICE 


CCC 


H 


SS 


DISKETTE 
DISK 


000-074 
000-302 


0-1 
0-1 


1-26 
0-59 



Your Action 
Reenter the response. 



id016E ENDING SECTOR OCCURS BEFORE STARTING SECTOR FOR DEVICE ddd 

Ending sector address on disk or Reprompts. 

diskette occurs before starting 
sector address. 



Reenter the response. 



idOlSA DEFAULT WORKSPACES (ccchss.ccchss) 

The text editor, assembler, and None. 

linkage editor require workspaces. 

The operator has the option of 

accepting the location and size 

of the default workspaces or 

specifying his own workspaces. 



idOl 9E INVALID RESPONSE - MUST BE YES OR NO 

The response to the prompt must Reprompts. 

be either YES or NO. 



Respond to this prompt with 
either YES or NO. YES designates 
that the default workspaces are 
to be used. NO designates that 
the operator will specify his own 
workspaces. If the response is NO, 
the processing program will 
prompt for required workspaces. 



Respond to the prompt with 
either YES or NO. 



id020E WORKSPACESl AND 2 OVERLAP 

WORKSPACESl and 2 were allocated Reprompts. 

the same or a portion of the same 

workspaces. 

id021E WORKSPACESl AND 3 OVERLAP 

WORKSPACESl and 3 were allocated Reprompts. 

the same or a portion of the same 

workspaces. 

id022E W0RKSPACES2 AND 3 OVERLAP 

W0RKSPACES2 and 3 were allocated Reprompts. 

the same or a portion of the same 

workspaces. 

id030E DEVICE NOT ATTACHED AT ADDRESS ddd 

The device at the specified device Reprompts. 

address is not attached to the 
system. An error in the response 
is assumed. 



Allocate separate workspaces 
for WORKSPACESl and 2 and 
reenter the response. 



Allocate separate workspaces 
for WORKSPACESl and 3 and 
reenter the response. 



Allocate separate workspaces 
for WORKSPACES2 and 3 and 
reenter the response. 



Reenter the response. 



id03 1 A DEVICE NOT READY AT ADDRESS ddd 

The device at the specified 
device address is not in the 
ready state. 



Waits until the device 
has been readied. 



Ready the appropriate device 
and generate an interrupt 
(hit any key) at the operator 
console. 



id032A END OF FORMS ON PRINTER 

The printer is out of paper. 



Waits until the printer 
has been adjusted. 



Add paper to the printer and 
ready the device. 
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id033A 



id034A 



id035A 



id036A 



id099I 



Message and Explanation 
PRINTER IN WAIT STATE 
The printer has been put in 
the wait state (hardware switch). 



System Action 

Waits until the printer 
has been readied. 



DISKETTE REMOVED PRIOR TO I/O COMPLETION AT ADDRESS ddd 
The diskette was removed while the Waits until the removed 

processing program was addressing it. diskette is returned. 

INVALID VOLl DISKETTE LABEL ON DEVICE ddd 

The VOLl label (sector 000007) Waits until the VOLl has 

is invalid. been corrected. 



REPLY TO WHEN THE DEVICE IS READY 
This message is printed after the 
following action messages: 

• id031A 

• id032A 

• id033A 

• id034A 

• id035A 

and is reissued if GO is not 
entered properly. 

LAST SECTOR WRITTEN = ccchss 
Each processing program that 
creates or moves data into a user 
data file identifies the sector 
address of the last sector 
written. 



Waits for operator reply. 



Your Action 
Ready the printer. 

Return the diskette to the drive. 



Initialize the diskette or correct 
the VOLl according to the fields 
defined in The IBM Diskette for 
Standard Data Interchange, Order 
Number GA21-9182-0. 



Rebuild the system. If the 
problem still persists, submit 
a Authroized Program Analysis 
Report (APAR) as outlined in the 
Program Logic Manual. 



None. 



None. 
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UNRECOVERABLE I/O AND SYSTEM MESSAGES 

Message and Explanation System Action Your Action 

id900T UNRECOVERABLE I/O ERROR: 

DEVICE = ddd Rebuild the system. If the problem 

ERROR CODE = nnnn still persists, submit a Authorized 

10 CC = n INT CC = n Program Analysis Report (APAR) as 

ISB = nnnn outlined in the Program Logic Manual. 

DEVICE ID = nnnn 
IDCB = nnnn nnnn 

CSSW = nnnn nnnn nnnn nnnn nnnn nnnn nnnn nnnn 
DCBl = nnnn nnnn nnnn nnnn nnnn nnnn nnnn nnnn 

DCB2 = nnnn nnnn nnnn nnnn nnnn nnnn nnnn nnnn 
SECTOR = ccchss 

An unrecoverable I/O error has Program abnormally 

occurred on the specified device. terminates. 

The error code describes the type 
of error which occurred last in 
the sequence of error recovery retries. 
Values for the error code: 
X'0412'- Device busy 
X'0413' - Control address marker present 
X'0414'- Parity error 
X'0415' - Intervention required 
X'0416' - Controller busy 
X'0417' - Invalid interrupt 
X'0418'- Printer error 
X'0419' - Printer error 
I X'041A'- No record found 
X'041B' - Track overflow 
X'041C' - Invalid surface side specified 
X'041E' - Command reject 
X'041F'- Protect check 

X'0420' - Address specification error, DCB specified error 
X'042r - Invalid storage address 
X'0422' - Invalid 10 command 

X*040F' - Unrecoverable error; check 10 CC, INT CC, ISB, and CSSW for error analysis 
The 10 CC is the 10 machine 
instruction code set by the 
last executed 10 instruction 
to the device. 

The IDCB field displays the 
operand of that I/O instruction. 
The INT CC is the condition code 
presented by the last interrupt 
from the device, and the ISB is the 
intenupt status byte associated 
with the interrupt. The DEVICE ID 
field identifies the device and 
must be considered when analyzing 
the ISB and IDCB field as described 
by the specified devices attachment 
hardware description, 
GA34-0023 IBM 4221 Diskette Unit 
Description 

GA34-0024 IBM 4211 Disk Storage 
Unit Description 
GA34-0025 IBM 0241 Printer 
Description 

GA34-0022 IBM 4011 Processor & 
Processor Feature Description 
GA34-0021 IBM 4021 Processor & 
Processor Feature Description 
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Message and Explanation 

The following is a brief procedure 

for error analysis: 

For cycle stealing devices, 

interrogate the information in the 

following steps: 

• Check for 10 CC errors 

• If 10 CC indicates success then 
check for INT CC errors 

• If INT CC exception condition, 
then check ISB for errors 

• If cycle steal status is 
available (as indicated by 
the ISB), then error status 
bits are set by the CSSW 
(cycle steal status words). 
Note. For non-cycle steal status 
available errors, the IDCB points 

to DCBl which is the last DCB issued 
to the device. The contents of DCBl 
are related to the type of command 
field and modifier in the IDCB. DCB2 
contains the READ/WRITE DCB last issued 
to the device. If the chain bit is on 
in DCBl, then DCB2 is chained to DCBl. 
For disk and diskette devices, SECTOR 
specifies the ccchss of the last 
sector attempted to be accessed if 
DCB2 contains a READ/WRITE command 
field. 



System Action 



Your Action 



id901T IOCS CALLER ERROR 

ERROR CODE = nnnn 

lOCB ADDRESS = nnnn 

lOCB = nnnn nnnn nnrm nnnn nnnn nnnn nnnn nnnn 
nnnn nnnn nnnn nnnn nnnn nnnn nnnn nnnn 
nnnn nnnn nnnn nnnn nnnn nnnn nnnn nnnn 
nnnn nnnn nnnn nnnn nnnn nnnn nnnn nnnn 
nnnn nnnn nnnn nnnn nnnn nnnn nnnn nnnn 

A system error has been detected. Same as id900T. 

Possible error codes: 

X'lOOr - InvaUd DDD pointer in lOCB 

X'1002' - Previously connected lOCB 

X'1003' - Un-CONNECTed lOCB (DCONNECT) 

X'2004' - CONNECT race detected 

X'2005' - Invalid lOCB-DDB physical record size 

X'2008' - Invalid internal CONNECT parameter 

X'2009' - Invalid DDB physical record size 

X'lOOA' - Invalid lOCB-DDB device ID 

X'l lOr - Invalid buffer address 

X'l 102' - Un-CONNECTed lOCB (READ/WRITE) 

X'1103' - Invalid lOCB on DDB-IOCB chain 

X'1104' - InvaUd lOCB self-pointer 

X'1105' - Invalid lOCB-DDB pointer on DDB-IOCB chain 

X'l 106' - InvaUd lOCB-DDB CONNECT status 



If the device is a disk or diskette 
and the error is determined 
to be no record found, assign 
the area designated by SECTOR an 
alternate location using the 
Disk/Diskette Initialization utility. 
If the error condition persists, the 
hardware device should be serviced. 
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Message and Explanation System Action 

id902T lOCB INVALID 

ERROR CODE = nnnn 

lOCB ADDRESS = nnnn 

lOCB = nnnn nnnn nnnn nnnn nnnn nnnn nnnn nnnn 
nnnn nnnn nnnn nnnn nnnn nnnn nnnn nnnn 
nnnn nnnn nnnn nnnn nnnn nnnn nnnn nnnn 
nnnn nnnn nnnn nnnn nnnn nnnn nnnn nnnn 
nnnn nnnn nnnn nnnn nnnn nnnn nnnn nnnn 

An error code other than those Same as id900T. 

listed in id900T and id901T is 

present. 



Your Action 



Same as id900T. 



id950I UNDETERMINABLE CHECK 

PSW SAR lAR LSR 

xxxx xxxx xxxx xxxx 
REGO REGl REG2 REG3 
xxxx xxxx xxxx xxxx 
An exception has occurred but the 
cause cannot be determined. 



REG4 REGS REG6 REG7 
xxxx xxxx xxxx xxxx 
Continues processing. 



Sameasid901T. 



id951T 



PROGRAM CHECK 






PSW 


SAR 


lAR 


LSR 




xxxx 


xxxx 


xxxx 


xxxx 




REGO 


REGl 


REG2 


REG3 


REG4 


xxxx 


xxxx 


xxxx 


xxxx 


xxxx 



A program check has occurred at 
location of lAR. 



REGS REG6 REG7 
xxxx xxxx xxxx 
Same as id900T. 



Same as id900T. 



id952I MACHINE CHECK 

PSW SAR lAR LSR 

xxxx xxxx xxxx xxxx 

REGO REGl REG2 REG3 REG4 

xxxx xxxx xxxx xxxx xxxx 

A machine check has occurred. 



REGS REG6 REG7 
xxxx xxxx xxxx 
Same as id900T. 



Same as id900T. 



id953T INVALID SVC 

PSW SAR 

xxxx xxxx 
REGO REGl 
xxxx xxxx 
A supervisor call 
No SVCs are supported 



lAR 


LSR 








xxxx 


xxxx 








REG2 


REG3 


REG4 


REGS REG6 


REG? 


xxxx 


xxxx 


xxxx 


xxxx xxxx 


xxxx 


been made. 




Same as id900T. 





Same as id900T. 



id954I POWER THERMAL WARNING 

PSW SAR lAR LSR 

xxxx xxxx xxxx xxxx 

REGO REGl REG2 REG3 REG4 

xxxx xxxx xxxx xxxx xxxx 

Power and/or thermal warning 

has occurred. 



REGS REG6 REG7 
xxxx xxxx xxxx 
Same as id950L 



Same as id900T. 



id955I INVALID TRACT REQ 

PSW SAR lAR 

xxxx xxxx xxx^ 
REGO REGl Reg2 
xxxx xxxx xxxx 
A trace request has been made. 
No trace requests are supported. 



LSR 




xxxx 




REG3 


REG4 


xxxx 


xxxx 



REGS REG6 REG7 
xxxx xxxx xxxx 

Same as id9S0I. 



Sameasid901T. 
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Message and Explanation 
id956I INVALID CONSOLE INTR 

PSW SAR lAR 

xxxx xxxx xxxx 
REGO REGl REG2 
xxxx xxxx xxxx 
A console interrupt has been made. 
The console interrupt function is 
not supported. 

id990T EXECUTION HALTED 

This message is printed after the 
following messages: 

• id951T 

• id952T 

• id953T 







System Action 




Your Action 


LSR 










xxxx 










REGS 


REG4 


REGS REG6 


REG7 




xxxx 
lade. 


xxxx 


xxxx xxxx 
Same as id950I. 


xxxx 


Sameasid901T. 



Same as id900T. 



Enter GO (CR) when the requested 
action from the previous action 
message has been taken. 



id999I FUNCTION TERMINATED 

REGS xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx 



This message is printed by the 
processing program upon detection 
of a terminal error and indicates 
abnormal termination. REGS 
displays the register contents at 
termination time. 



Same as id900T. 



If a full function console is 
present, do not depress CONSOLE 
INTERRUPT during processing. If 
a full function console is not 
present, same as id901T. 
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CH-CREATE DISKETTE HDRl MESSAGES 

Message and Explanation System Action 

CHI 10 A DEVICE ADDRESS= 

A prompt requesting the diskette Waits for input, 

device address. 



Your Action 

Enter a 3-character device 
address in ddd format. 



CH120A HEADER NAME= 

A prompt requesting the name of 
the data file described by the 
HDRl record. 



Waits for input. 



Enter a 1- to 8-character 
alphameric name in cccccccc format. 



CHI 30 A EXTENTS= 

A prompt requesting the starting 
and the ending sector addresses of 
the data file to be defined by this 
HDRl record. 



Waits for input. 



Enter the starting and ending 
sector addresses in ccchss.ccchss 
format. 



CH140A END OF DATA= 

A prompt requesting the address, 
within the data file, that contains 
the last data item. 



Waits for input. 



Enter the address in ccchss format. 



CH146E EXCHANGE DATA AREAS MUST LIE ON CYLINDERS 1 THRU 73 
Cylinders and 74 are reserved on Reprompts. 

basic exchange diskettes. 



Reenter the exchange data areas 
on cylinders 1 thru 73. 



CH200E END OF DATA NOT WITHIN EXTENTS 
The ccchss given for the end of file 
is greater than the end of extent 
ccchss or less than the beginning 
of extent ccchss. 



Reissues prompt for the 
end of file ccchss. 



Reenter the vaUd end of file. 



CH215E EXTENTS NOT COMPARIBLE WITH EXISTING HDRl 

The proposed data set overlaps Reprompts. 

an existing data set and can 
not be built. 



Look at HDRl's on the diskette 
and pick the beginning and ending 
extents to avoid conflict. 



CH230E ALL HDRl's IN USE - UNABLE TO CREATE 
All 19 HDRl's on this diskette are 
in use. 



Reprompts. 



Delete a data set to recover 
a HDRl or get a diskette with 
free HDRl's. 



CH240E 



EXTENT ARRANGEMENT INDICATOR NOT COMPATIBLE 



The extent arrangement indicator in the 
VOLID was P a flag indicating that the 
extents must be adjacent and that all 
unallocated space must follow the last 
data set extent on the volume, and 
creation of this data set would cause 
either the data sets to not be in ccchss 
order or not all of the free space to be 
at the end. 



Reprompts. 



Set up the beginning ccchss to 
follow directly after the last 
contiguous data set on the volume. 



CH250E DUPLICATE NAME ON VOLUME 
Header name given matches the 
HDRl name already on the diskette. 



Reprompts. 



Pick a new data set name and 
restart the program. 



CH260E UNABLE TO READ HDRl 

Invalid extents (BOE or EOE) on the 
HDRl were read from the diskette 
or an unrecoverable I/O error on 
the HDRl was read. 



Reprompts. 



Check the HDRl's. If they are all 
valid, retry. If the message persists, 
copy to a new diskette and retry. 
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Message and Explanation 

CH299T CREATE HDRl CYCLE ERROR END 
The program is recycled. 

CH401E INPUT MESSAGE TOO LONG 
All expected fields were found 
before the end of the input message. 



System Action 



The program terminates. 



Reprompts. 



Your Action 
None. 



Check for an extra field, wrong 
input type, misplaced comma or too 
many characters in the last field. 
Reenter the corrected data. 



CH402E FIELD TOO LONG OR DELIMITER ERROR 
Too many characters were detected 
prior to a comma or blank field 
delimiter. 



Reprompts. 



Correct and reenter the input. 



CH405E INPUT NAME IS INVALID 

An illegal character or a null name 
was entered in the name field. 



Reprompts. 



Correct and reenter the input. 



CH406E INVALID CHARACTER IN INPUT FIELD 
Conversion returned the invalid 
character code. A non-decimal 
digit was entered in the converted 
field. 



Reprompts. 



Correct and reenter the input. 
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DH-DELETE DISKETTE HDRl MESSAGES 

Message and Explanation 
DHUOA DEVICE ADDRESS= 

A prompt requesting the diskette 
device address. 



DH120A 



DH240E 



HEADER NAME= 

A prompt requesting the name of 

the HDRl record to be deleted. 



System Action 



Waits for input. 



Waits for input. 



EXTENT ARRANGEMENT INDICATOR NOT COMPATIBLE 

Extent arrangement indicator (EAI) is Reprompts, 

P a flag indicating that the extents must 

be adjacent and that all unallocated 

space must follow the last data set 

extent on the volume, and the data set 

to be deleted is not the last physical 

HDRl on the diskette. Only the last 

may be deleted. 



Your Action 

Enter a 3-character device address 
in ddd format. 



Enter a 1- to 8-character 
alphameric name in cccccccc format. 



Delete all foUovi^ing HDRl's 
first. 



DH250E HDRl NAME NOT FOUND 
Data file name supplied is not 
on the diskette. 



Reprompts. 



Get the correct data file name 
and restart the program. 



DH260E UNABLE TO READ HDRl 

Invalid extents (BOE or EOE) 
on the HDRl were read from the 
diskette or an unrecoverable I/O 
error on the HDRl was read. 



Reprompts. 



Check the HDRl's. If they are all 
valid, retry. If the message persists, 
copy to a new diskette and retry. 



DH299T DELETE HDRl CYCLE ERROR END 
The program is recycled. 

DH401E INPUT MESSAGE TOO LONG 
All expected fields were found 
before the end of the input message. 



DH402E FIELD TOO LONG OR DELIMITER ERROR 

Too many characters were detected 
prior to a comma or blank field 
delimiter. 



The program terminates. 
Reprompts. 

Reprompts. 



None. 



Check for an extra field, wrong 
input type, misplaced comma or 
too many characters in the last 
field. Reenter the corrected data. 

Correct and reenter the input. 



DH405E INPUT NAME IS INVALID 

An illegal character or a nuU name 
was entered in the name field. 



Reprompts. 



Correct and reenter the input. 



DH406E INVALID CHARACTER IN INPUT FIELD 
Conversion returned the invalid 
character code. A non-decimal 
digit was entered in the converted 
field. 



Reprompts. 



Correct and reenter the input. 
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FD-DISK TO PRINTER DUMP MESSAGES 

Message and Explanation System A ction 

FDIOOA DISK AREA= 

A prompt requesting the location None, 

of the data file to be dumped. 



Your Action 

Enter the location of the data 
file in ddd,ccchss,ccchss format. 



FD202I DISK TO PRINTER DUMP CYCLE ABNORMALLY TERMINATED 

The dump cycle has been terminated. Reprompts. 



Reenter the response. 
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FI-DISK INITIALIZATION MESSAGES 

Message and Explanation System Action 

FI003I PRIMARY INITIALIZATION MODE 

This mode was chosen and the None, 

given disk is to be reinitialized. 



Your Action 
None. 



FI004I ALTERNATE SECTOR MODE 

Ihis mode was chosen and an 
alternate is to be assigned to 
the specified sector. 



None. 



None. 



FIl lOA DEVICE ADDRESS= 

A prompt requesting the disk device 
address. 



Waits for the input. 



Enter a 3-character device 
address in ddd format. 



FIl 20 A TYPE= 

A prompt requesting the type of 
initialization to be performed. 



Waits for the input. 



Enter either PI for primary 
initialization or AS for 
alternate sector assignment. 



FI121E INVALID TYPE -MUST BE PI OR AS 

An incorrect initialization type 
has been entered in the response 
to TYPE= prompt. 



Reprompts for initiaUzation 
type via the TYPE= prompt. 



Respond to the prompt with PI for 
primary initialization or AS 
to assign an alternate sector. 



FIl 30 A SECTOR ADDRESS= 

A prompt requesting the sector 
address of the defective sector 
for alternate assignment. 



Waits for input. 



Enter the sector address of the 
defective sector in ccchss format. 



FI140I ALTERNATE SECTOR ASSIGNED FOR ccchss 

An alternate sector is assigned 
for defective sector ccchss. 



None. 



None. 



FI14 1 T ALTERNATE SECTOR ALREADY ASSIGNED 

An alternate sector has already 
been assigned. 



Program terminates. 



Program error. Retry with a rebuilt 
system. If error persists, then 
perform software maintenance. 



FI142W UNABLE TO MARK DEFECTIVE ALTERNATE FOR CCCHSS = ccchss 

Alternate sector assignment is None, 

unable to mark the alternate 
for ccchss as defective, but a 
new alternate has been assigned. 



Avoid use of the sector ccchss 
because data loss may occur. 



FI143W DATA RECOVERY FAILED 

Data from the bad sector has not 
been recovered. 



None. 



Data from the sector reassigned 
is lost. 



FI150A ARE DEFECTIVE SECTOR FLAGS INVALID 

A prompt requesting whether the 
defective flags are invalid. 



Waits for input. 



Enter either YES or NO. YES allows 
a disk with invalid sector flags to 
be processed. 

Note. Reply YES only if the disk 
cannot be initialized; otherwise, 
enter NO unless the defective 
sector flags have been destroyed. 



FI151 A REPLY TO DEFECTIVE FLAG PROMPT MUST BE YES OR NO 

Reply to the defective flag prompt Reprompts. 

must be YES or No. Any other 
response is invalid. 



Reenter the response to the invalid 
sector flag prompt as either 
YES or NO. 
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Message and Explanation System A ction 

FI200T ALTERNATE SECTORS NOT ASSIGNED FOR CYLINDER 1 

An attempt was made to assign an Program terminates. 

alternate to a sector on cylinder 

1. Cylinder 1 is reserved 

to contain only alternate 

sectors. 



Your Action 

If the intent is to assign an 
alternate to a bad alternate 
sector, the ccchss of the 
original bad sector should be 
used in requesting the alternate 
sector assignment. Any unassigned 
bad sector on cylinder 1 should 
be marked as defective and 
ignored. 



FI210W SECTOR ccchss ON CYLINDER 1 HAS BEEN MARKED DEFECTIVE 
Ihe noted sector on the None, 

alternate cylinder has been 
marked as defective an4 cannot 
be used in alternate sector 
assignment. 



The number of such messages 
during an initialization should 
be logged. This number added to 
the number of alternates assigned 
tells the number of sectors used 
on Cyl 1. This keeps track of 
the available alternates. 



FI220W 



UNABLE TO MARK SECTOR AT ccchss AS DEFECTIVE 



Disk Initialization has determined 
that ccchss is defective, but it 
has been unable to mark it as 
such. An alternate has been assigned. 
If the error on sector ccchss is 
intermittent, this could cause the 
original damaged sector to be 
referenced in subsequent I/O 
operations, ccchss is the cylinder, 
head, sector address of the sector 
referenced. 



None. 



None. 



FI230T UNABLE TO ASSIGN ALTERNATE SECTOR - ALTERNATE CYLINDER FULL 

Alternate sector assignment has Program terminates, 

been requested, but an alternate 
can not be assigned, because there 
are no free alternates to use. 



Since an alternate can not be 
assigned on the alternate 
cylinder, the user must either 
avoid the bad sector or program 
an error recovery for this case. 
The condition should be reported, 
because the normal error 
recovery route is now blocked and 
the disk can probably not be 
initialized. In which case the 
entire disk should be considered 
defective. 



FI240T UNABLE TO INITIALIZE - TOO MANY BAD SECTORS 

Primary initialization has been Program terminates, 

attempted and more than 120 
bad sectors have been found. 



The disk file is unusable. 



FI401E INPUT MESSAGE TOO LONG 

All expected fields were found 
before the end of the input 
message. 



Reprompts. 



Check for an extra field, wrong 
input type, misplaced comma or too 
many characters in the last field. 
Reenter the corrected data. 



M-14 GC34-0070 



Message and Explanation System Action 

FI402E FIELD TOO LONG OR DELIMITER ERROR 

Too many characters were detected Reprompts, 

prior to a comma or blank field 

delimiter. 



Your Action 

Correct and reenter the input. 



FI405E INPUT NAME IS INVALID 

An illegal character or null name 
was entered in the name field. 



Reprompts. 



Correct and reenter the input. 



FI406E INVALID CHARACTER IN INPUT FIELD 

Conversion returned the invalid 
character code. A non-decimal digit 
was entered in the converted field. 



Reprompts. 



Correct and reenter the input. 
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FR-DISK TO DISKETTE COPY MESSAGES 

Message and Explanation System Action 

FRIOOA FROM DATA AREA= 

A prompt requesting the source data None, 

file information. 



Your Action 

Enter the source data file 
information in ddd,ccchss,ccchss 
format. 



FR102E DISK TO DISKETTE COPY CYCLE ABNORMALLY TERMINATED 
The copy cycle has been terminated Reprompts. 

without completion. 



Reenter the response. 



FR200A TO DATA AREA= 

A prompt requesting the destination 
data file information. 



None. 



Enter the destination data file 
information in ddd,ccchss,ccchss 
format. 



FR420E INVALID DESTINATION DATA FILE - INSUFFICIENT SIZE 
The destination data file is too Reprompts. 

small to hold the copy of the 
source data file. 



Reenter the response. 
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IP-BOOTSTRAP/LOADER DISK MESSAGES 

Message and Explanation 
IPIOOA EXEC= 

The loader prompts for the name 
or the starting sector address of 
the program to be executed. 



System Action 

Waits for the input from 
the operator station. 



Your Action 

Enter a 2-character IBM supplied 
ID or the ccchss of the program. 



IP200E PROGRAM TOO LARGE FOR STORAGE 

$IPTLODR determined that the 
requested program to be loaded 
wUl not fit in the available 
storage. 



Reprompts for the next 
request. 



Request another program 
to be loaded. 



IP2 1 OE INVALID PROGRAM HEADER 

The header at the location that 
the operator requested was invalid. 



Issues another prompt to 
the operator. 



Determine if the location on 
the disk for the program is 
correct and reenter. 



IP220E PROGRAM NOT FOUND 

The requested program to be loaded 
was not on the disk. 



Reprompts for the next 
request. 



Request another program to be 
loaded. 



IP230E STARTING SECTOR ADDRESS INVALID 

The ccchss value is either out of 
range for the device or a non- 
numeric value is used. 



Reprompts. 



Determine the correct value 
and reenter. 



IP-BOOTSTRAP/LOADER DISK WAIT CODES 






Wait Code and Explanation 


System Action 


Your Action 


X'610E' 


Machine check. 


Program terminates. 


None. 


X'610F' 


Program check. 


Program terminates. 


None. 


X'61CC 


I/O error preparing printer. 


Program terminates. 


None. 


X'61DD' 


I/O error preparing operator 
station. 


Program terminates. 


None. 


X'61BB' 


I/O error printer. 


Program terminates. 


None. 


X*61BC' 


I/O error operator station (write). 


Program terminates. 


None. 


X'61AA' 


I/O error operator station (read). 


Program terminates. 


None. 


X'61AB' 


I/O error disk, start. 


Program terminates. 


None. 


X'61CD' 


I/O error disk, end of track. 


Program terminates. 


None. 


X'6188' 


No ISB (instruction status block) stored. 


Program terminates. 


None. 


X'6120' 


No record found. 


Program terminates. 


None, 


X'61FF 


Loader error. 


Program terminates. 


None, 


X'6199' 


Unrecoverable I/O error. 


Program terminates. 


None, 
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PI -STORAGE TO PRINTER DUMP WAIT CODES 

Wait Code and Explanation System A ction Your A ction 

X'61EE' Too many alternate cylinders. Program terminates. None. 

X*610F' Program check. Program terminates. None. 

X'610E' Machine check. Program terminates. None. 

X'6106' End of diskette. Program terminates. None. 

X'61AB' I/O error disk, start. Program terminates. None. 

X'6120' No record found. Program terminates. None. 

X'6199' Unrecoverable I/O error. Program terminates. None. 

X'6188' No ISB (instruction status block) stored. Program terminates. None. 
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RD-DISKETTE TO PRINTER DUMP MESSAGES 

Message and Explanation System Action 

RDIOOA DISKETTE AREA= 

A prompt requesting the location None, 

of the data file to be dumped. 



Your Action 

Enter the location of the data 
file in ddd,ccchss,ccchss format. 



RD202I DISKETTE TO PRINTER DUMP CYCLE ABNORMALLY TERMINATED 

ITie dump cycle has been terminated. Reprompts. 



Reenter the response. 
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RF-DISKETTE TO DISK COPY MESSAGES 

Message and Explanation System Action 

RFIOOA FROM DATA AREA= 

A prompt requesting the source data None, 

file information. 



Your Action 

Enter the source data file 
information in ddd,ccchss,ccchss 
format. 



RF102E DISKETTE TO DISK COPY CYCLE ABNORMALLY TERMINATED 
The copy cycle has been terminated Reprompts. 

without completion. 



Reenter the response. 



RF200A TO DATA AREA= 

A prompt requesting the destination 
data file information. 



None. 



Enter the destination data file 
information in ddd,ccchss,ccchss 
format. 



RF420E INVALID DESTINATION DATA FILE - INSUFFICIENT SIZE 
Ihe destination data file is too Reprompts. 

small to hold the copy of the 
source data file. 



Reenter the response. 
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RI-DISKETTE INITIALIZATION MESSAGES 



Message and Explanation 
RIUOA DEVICE ADDRESS= 

A prompt requesting the device 
address of the diskette to be 
initialized. 



RI120A 



RI125I 



RI127A 



RI202T 



RI205I 



RI137I 



NEWVOLID= 

A prompt requesting the VOLID to 

be written to the diskette. 

CURRENT VOLID = cccccc 
An informational message which 
supplies the CURRENT VOLID. 



System Action 
None. 

None. 
None. 



Your Action 

Enter a 3-character device 
address in ddd format. 



Enter a 1- to 6-character 
alphameric name in cccccc format. 



None. 



DO YOU WANT TO INITIALIZE THIS DISKETTE? RESPOND YES OR NO. 

A prompt which is issued when the None 

supplied NEW VOLID is different from 

the existing CURRENT VOLID on the 

diskette. 



RIl 29 A INVALID RESPONSE - MUST BE YES OR NO 

An invalid response has been Reprompts. 

entered for the prompt from 
message RIl 27 A. 

RIl 331 INVALID VOLl LABEL 

The diskette has a VOLl label which None, 

is either not standard or destroyed. 



Enter YES or NO. 



Enter YES or NO. 



None. 



None. 



None. 



RIl 351 VOLID IS BLANK 

The VOLID of the VOLl label is 
blank. 

RI140I DEFECTIVE CYLINDER cch 

An informational message which is 
issued for each defective cylinder, 
cc is the decimal number of the 
defective cylinder and h is the 
decimal number of the head. 



RI200T UNABLE TO INITIALIZE - TOO MANY DEFECTIVE CYLINDERS 

Two cylinders on a diskette Program terminates, 

may be formatted as bad. If 
more exist, the diskette is 
considered defective. 



None. 



None. 



UNABLE TO INITIALIZE - DEFECTIVE DISKETTE 



Program terminates. 



Either cylinder is bad or the 
utility is unable to format a 
cylinder as defective because the 
entire cylinder is bad. 



DISKETTE INITIALIZATION ABNORMALLY TERMINATED 
This message is issued when a Reprompts. 

reply of NO is entered for the 
message RIl 27 A. 



CYLINDER IS UNFORMATTED 
Cylinder has either never been formatted 
or has been destroyed. 



None. 



Get a new diskette. Old one 
is defective. 



Get a new diskette. Old one is 
defective. 



Change the diskette or terminate 
the program. 



None. 
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Message and Explanation System Action 

RI401E INPUT MESSAGE TOO LONG 

All expected fields were found Reprompts. 

before the end of the input 

message. 



Your Action 

Check for an extra field, wrong 
input type or too many characters 
in the field. Reenter the corrected 
data. 



RI402E FIELD TOO LONG OR DELIMITER ERROR 

Too many characters were Reprompts. 

detected prior to a comma or 
blank field delimiter. 

RI405E INPUT NAME IS INVALID 

An illegal character or null name Reprompts. 

is entered in the name field. 

RI406E INVALID CHARACTER IN INPUT FIELD 

Conversion returned the invalid Reprompts. 

character code. A non-decimal 
digit is entered in the converted 
field. 



Correct and reenter the input. 



Correct and reenter the input. 



Correct and reenter the input. 
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SB-AUTOMATIC SYSTEM BUILD 

Message and Explanation 
SB200E HDRl NOT FOUND 

The HDRl supplied is not on the 
diskette. 



System Action 
Program terminates. 



Your Action 

Qieck diskette HDRl's and make 
sure that the required files have 
HDRl's. Correct HDRl's and reload 
the diskette. 



SB2 1 OT INVALID PROG HEADER 
There is an invalid header at 
the location read by the loader. 



Program terminates. 



Check the PID diskettes HDRls 
and ensure that the required 
files have valid headers. 



SB220E PROG NOT FOUND 

The Automatic System Build 
program is not found. 



Program terminates. 



Check the Automatic System Build 
program (ID=SB) which resides at 
diskette address ccchss=002001. 
Correct the program and rerun. 



SB240T PROG TOO LARGE FOR STORAGE 
SSBLOADR determined that the 
Automatic System Build program 
will not fit in storage. 



SB300E UNABLE TO READ VOLl AND/OR HDRl 
The Automatic System Build program 
is unable to read the VOLl and/or 
the HDRl. 



Program terminates. 



Program terminates. 



Check the size field in the HDRl 
for ID=SB and ensure that it has 
not been modified. Correct the 
program and rerun. 



The diskette is not properly formatted. 
Correct the format and reload the 
diskette. 



SB400E DISKETTE VOLID = nnnnnn NOT COPIED 
The diskette VOLID is not copied. 



Program terminates. 



An unrecoverable I/O error has 
occurred. The I/O should output 
the cause of the error. Correct 
the program and rerun. 
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SF- SYSTEM VERIFICATION MESSAGES 

Message and Explanation 
SF400E INVALID HEADER ON DISK 
The header was encountered 
with an invalid header ID. 

SF5 OOE module name NOT ON DISK 

The module whose name appears in 
the message text was not found 
on the disk system. 

SF600E module name NOT IN SYSTEM TABLE 
The module whose name appears in 
the message text was not found 
in the system table. 

SF700E INVALID HEADER CHAIN 

The header for the end of the 
PP modules was encountered 
before the header for the SCP 
modules on the disk. 



System Action 
Program terminates. 

Program terminates. 

None. 

Program terminates. 



Your Action 

Check the header ID for the 
header record. 



Determine why the module was 
not located on the disk. 



Check the program name for the 
header record. 



Check the location of the headers 
for the end of the SCP modules and 
the end of the PP modules. 
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SI -STORAGE TO DISKETTE DUMP WAIT CODES 

Wait Code and Explanation System Action Your Action 

X'61EE' To many alternate cylinders. Program terminates. None. 

X'610F' Propam check. Program terminates. None. 

X'610E' Machine check. Program terminates. None. 

X'6106' End of diskette. Program terminates. None. 

X'61AB' I/O error disk, start. Program terminates. None. 

X'6120' No record found. Program terminates. None. 

X'6199' Unrecoverable I/O error. Program terminates. None. 

X'6188' No ISB (instruction status block) stored. Program terminates. None. 
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TF-DISK PATCH MESSAGES 

Message and Explanation System A ction 

TFl OOE INVALID DISPLACEMENT - NON-DECIMAL DIGIT 

The byte displacement into the Reprompts. 

sector is not a decimal digit. 
The byte displacement is the 3rd 
parm used to describe the patch 
location in response to PATCH 
AREA=ddd,ccchss,bbb,nnn. The 
byte displacement (bbb) must be 
3 decimal digits. 



Your Action 

Reenter the patch data with the 
correct byte displacement. 



TFIOIE INVALID DISPLACEMENT - 3 DIGITS REQUIRED 

The byte displacement into the Reprompts. 

sector is not 3 decimal 

digits. The byte displacement 

is the 3rd parm used to describe 

the patch location in response 

to PATCH AREA=ddd,ccchss,bbb,nnn. 

The byte displacement (bbb) must be 

3 decimal digits. 



Reenter the patch data with the 
correct byte displacement. 



TF102E INCORRECT NUMBER OF PARAMETERS - 4 REQUIRED 
The expected number of parameters Reprompts. 

was not received. The response to 
the prompt message PATCH AREA= must 
be of the form ddd,ccchss,bbb,nnn. 



Reenter the patch data with the 
correct number of parameters. 



TF104E INVALID BYTE COUNT - NON-DECIMAL DIGIT 

The number of bytes to display Reprompts. 

for verification is not a decimal 
digit. The byte verification count 
(nnn) must be 3 decimal digits. 



Reenter the patch data with the byte 
verification count in decimal. 



TFl 05E INVALID BYTE COUNT - 3 DIGITS REQUIRED 

The number of bytes to display for Reprompts. 

verification is not 3 decimal 

digits. The byte verification 

count (nnn) must be 3 decimal digits 

greater than but less than 257. 



Reenter the patch data with 3 
decimal digits. 



TFl 06E PATCH EXCEEDS SECTOR BOUNDARY 
When either the number of bytes 
to display for verification or 
the actual patch data is added to 
the byte displacement, the result 
is greater than 256. The data would 
be beyond the extent in bytes of 
the sector vdthin which the 
patch should be applied. 



Reprompts. 



Reenter the patch data with the 
corrections. 
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Message and Explanation 
TF107E INVALID HEX DATA 

The replacement data for the 
patch was not entered in the form 
hhhh hhhh . . . , where hhhh is a 
2-byte hexadecimal group of data. 

TF200A PATCH AREA= 

A prompt requesting the location on 
the disk to be patched. 

TF201A REPLACEMENT DAT A= 

A prompt requesting the replacement 
data to be patched. 



System Action 
Reprompts. 



None. 



None. 



Your Action 

Reenter the patch data from the 
beginning of the patch session. 



Enter the requested information in 
ddd,ccchss,bbb,nnn format. 



Enter either groups of four 
hexadecimal characters, separated 
by blanks in hhhh hhhh . . . format, 
or if no patch is to be applied, 
enter NONE. 



TF202I DISK PATCH CYCLE ABNORMALLY TERMINATED 

Error cycle end message appearing Recycles and reprompts. 

after verify or replacement 
functions are abnormally 
terminated. 



Reenter the corrected response to 
the prompt. 
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System Action 
Reprompts. 



TR-DISKETTE PATCH MESSAGES 

Message and Explanation 
TRIOOE INVALID-NON-DECIMAL DIGIT 
The byte displacement into the 
sector is not a decimal digit. 
The byte displacement is the 3rd 
parm used to describe the patch 
location in response to PATCH 
AREA=ddd,ccchss,bbb,nnn. The byte 
displacement (bbb) must be 3 decimal 
digits. 



TRIOIE INVALID DISPLACEMENT- 3 DIGITS REQUIRED 

Hie byte displacement into the Reprompts. 

sector is not 3 decimal 

digits. The byte displacement is 

the 3rd parm used to describe the 

patch location in response to 

PATCH AREA=ddd,ccchss,bbb,nnn. 

The byte displacement (bbb) must be 

3 decimal digits. 



Your Action 

Reenter the patch data with the correct 
byte displacement. 



Issue error message. Start the patch 
processing loop again with the 
prompt message PATCH AREA=. 
Reenter the patch data with the 
correct byte displacement. 



TRl 02E INCORRECT NUMBER OF PARAMETERS - 4 REQUIRED 
The expected number of parameters Reprompts. 

was not received. The response to the 
prompt message PATCH AREA= must be 
of the form ddd,ccchss,bbb,nnn. 



Issue error message. Start the patch 
processing loop again with the 
prompt message PATCH AREA=. 
Reenter the patch data with the 
correct number of parameters. 



TR104E INVALID BYTE COUNT- NON DECIMAL DIGIT 

The number of bytes to display Reprompts. 

for verification is not a decimal 
digit. The byte verification count 
(nnn) must be 3 decimal digits. 



Reenter the patch data with the 
byte verification count in decimal. 



TR105E 



TR106E 



INVALID BYTE COUNT- 3 DIGITS REQUIRED 

Ihe number of bytes to display Reprompts. 

for verification is not 3 decimal 

digits. The byte verification count 

(nnn) must be 3 decimal digits 

greater than but less than 129. 



PATCH EXCEEDS SECTOR BOUNDARY 

When either the number of bytes 

to display for verification or 

the actual patch data is added to 

the byte displacement, the result 

is greater than 128. The data 

would be beyond the extent in 

bytes of the sector within which 

the patch should be applied. 



Reprompts, 



Reenter the patch data with 3 
decimal digits. 



Reenter the patch data with the 
corrections. 



TR107E INVALID HEX DATA 

The replacement data for the 
patch was not input in the form 
hhhh hhhh. . . , where hhhh is a 
2-byte hexadecimal group of 
data. 



Reprompts. 



Reenter the patch data. 



TR200A PATCH AREA= 

A prompt requesting the location on 
the diskette to be patched. 



None. 



Enter the requested information in 
ddd,ccchss,bbb^nn format. 
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TR201A 



Message and Explanation 
REPLACEMENT DATA= 
A prompt requesting the replacement 
data to be patched. 



System Action 
None. 



TR202I 



DISKETTE PATCH CYCLE ABNORMALLY TERMINATED 

Error cycle end message appearing Recycles and reprompts. 

after verify or replacement 

functions are abnormally terminated. 



Your Action 

Enter either groups of four 
hexadecimal characters, separated 
by blanks in hhhh hhhh... format, 
or if no patch is to be applied, 
enter NONE. 

Reenter the corrected response to 
the prompt. 
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